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© A computer software compiler system and method (234) for distributing a machine independent computer 
program (202), created on a native computer platform (206), to heterogeneous target computer platforms (216, 
226). The system (234) is comprised of a producer component (208) and one or more installer components (218, 
228). The producer component (208) receives the machine independent computer program (202) as input and 
generates a compiler intermediate representation (212) in a machine independent manner according to a 
compiler intermediate language. The compiler intermediate representation (212) is architecture neutral and 
represents an architecture neutral distribution format (ANDF). The compiler intermediate representation (212) is 
distributed to heterogeneous target computer platforms (216, 226) where the installer components (218, 228) 
reside. The installer components (218, 228) receive the compiler intermediate representation (212) as input and 
generates object code representations (222, 232) in a machine dependent manner according to the compiler 
intermediate language, such that the object code representations (222, 232) are architecture dependent, or 
machine dependent, on the target computer platforms (216, 226). 
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BACKGROUND OF THE INVE NTION 

The present invention relates generally to computer software compiler systems and methods, and 
specifically to computer software compiler systems and methods for enhanced distribution of computer 
5 software. 

Ideally, the same version of a computer program could be distributed to heterogeneous computer 
platforms (heterogeneous computer platforms being computer platforms having different computer architec- 
tures and different computer operating systems). The computer program would operate, without modifica- 
tions, on the heterogeneous computer platforms. 

iQ This distribution ideal is desirable for a number of reasons. Ftrst the availability of computer software is 
enhanced if software is easily distributed. For end-users, easily-distributed computer programs means that 
their software acquisition and purchasing tasks are simplified. For software vendors, easily-distributed 
computer programs means their stocking and distribution costs are minimized. 

Additionally, for software producers, easily-distributed computer programs are desirable for economic 

15 efficiency reasons. Initial development and subsequent maintenance costs would be minimized if a 
programming team could limit their design, implementation, and maintenance efforts to a single computer 
program version. Distribution costs would also be minimized if a single computer program version could be 
marketed to heterogeneous computer platforms. 

The ability to reach this distribution ideal depends on two factors: the manner in which software is 

20 written and the format in which software is distributed. 

Today, software is ordinarily written in a machine dependent manner. For example, software written for 
an IBM Personal Computer (IBM PC) will often use the function calls that are provided by DOS (Disk 
Operating System), the IBM PC operating system. Such software is machine dependent because it includes 
references to specific features (i.e., DOS function calls) of a particular computer platform {i.e., the IBM PC). 

25 Machine dependent software can operate only on its native computer platform {i.e., the computer 
platform on which it was created). Modifications are necessary for it to operate on other computer platforms. 
Therefore, machine dependent software is economically inefficient because separate versions of each 
computer program are required, one for each target computer platform (i.e., a computer platform on which a 
computer program is meant to operate). 

30 It is possible to write software so that it does not depend on the specific features of any particular 
computer platform. That is, software that depends neither on the specific hardware nor specific software 
features of any particular computer platform. Such software is said to be machine independent, Theoreti- 
cally, machine independent software (or machine independent computer programs) can operate on 
heterogeneous target computer platforms without any modifications. 

35 But the ability of software to operate on heterogeneous target computer platforms also depends on the 

manner in which software is distributed (i.e., the format of the software distribution copy). There are two 
software distribution formats: an architecture neutral distribution format and an architecture dependent 
distribution format. 

A machine independent computer program that is distributed in the architecture dependent distribution 
40 format (A DDF) can only operate on its native computer platform. Object and executable code formats are 
examples of ADDFs. ADDFs are inefficient because multiple versions of the software distribution copy are 
required, one for each heterogeneous target computer platform. 

Conversely, a machine independent computer program that is distributed in the architecture neutral 
distribution format (ANDF) can operate on any computer platform. Thus, ANDFs are efficient because only 
46 one version of the software distribution copy is required, and this version can be distributed without 
modifications to heterogeneous target computer platforms. 

Therefore, the distribution ideal is reached through the combination of machine independent computer 
programs plus ANDF. That is, the combination of machine independent computer programs plus ANDF 
produces computer programs that can operate, without any modifications, on heterogeneous computer 
so platforms. 

There have been many attempts at defining a working ANDF specification. Perhaps the first attempt 
was in 1969 with the creation of UNCOL. UNCOL was a compiler intermediate language which had some 
ANDF features. The creators of UNCOL, however, were not attempting to define an ANDF specification. 
Thus, UNCOL, while having some ANDF features, was not a complete ANDF specification. 
55 in November 1988, the European Roundtable commissioned Logica to perform an ANDF feasibility 

study. The Logica study, which was completed in April 1989, reiterated the goals, the requirements, and the 
impact of ANDF, but did not define a complete ANDF specification. 

in April 1989 : the Open System Foundation (OSF) solicited proposals, via a Request for Technology 
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(RFT), for an ANDF standard for Unix computer platforms. OSF received over 20 proposals (hereinafter 
referred to as the "OSF proposals") in response to its RFT. 

Generally, ANDF specification proposals are based on one of the four generally accepted ANDF 
approaches: ANDF Using Source Code; ANDF Using Encrypted Source Gode; ANDF Using Tagged 
5 Executable Code; and ANDF Using Compiler intermediate Representation. 

The first ANDF approach, ANDF Using Source Code, uses the computer program source code as the 
software distribution format. Under this approach, machine independent source code is distributed to 
heterogeneous target computer platforms. At each target computer platform, computer operators use their 
compilers to compile their source code copies. 
w The ANDF Using Source Code approach, however, is inherently flawed because proprietary secrets, 
embedded within the source code, cannot be protected if the source code is used as the ANDF. Therefore, 
distributing computer programs at the source code level, although being architecturally neutral, is not 
feasible for most business applications. 

The second ANDF approach, ANDF Using Encrypted Source Code, is a variation of the first. Under this 
15 approach, encrypted source code is distributed to heterogeneous target computer platforms. The operators 
at each target computer platform use special compilers to compile their copies of the encrypted source 
code. These special compilers tiave two parts, an decrypter and a conventional compiler. The special 
compilers first decrypt, and then compile, the encrypted source code. 

The ANDF Using Encrypted Source Code approach seemingly solves the security problem of the first 
20 approach, since embedded proprietary secrets are protected by the encryption process. The security 
problem is not completely solved, however, because the de-encrypted source code can be intercepted after 
de-encryption by the special compiler. Thus, like the first approach, the ANDF Using Encrypted Source 
Code approach is inherently flawed because it exposes embedded proprietary secrets to the public. 

Under the third ANDF approach, ANDF Using Tagged Executable Code, the software distribution format 
25 is composed of a first part and a second part. The first part contains executable code in the native 
computer platform's machine language. The second part contains information concerning the native 
computer platform's machine language. This second part is called a Key. 

Special compilers use the Key to convert the first part of the software distribution copy to executable 
code for their respective target computer platforms. 
30 This third ANDF approach, however, is inherently flawed because it is not truly architecturally neutral. 
Instead, it is architecturally biased. 

The fourth ANDF approach, ANDF Using Compiler intermediate Representation, uses a compiler 
intermediate representation as the software distribution format. To understand this approach, it is necessary 
to describe some high-level software compiler concepts, 
35 Software compilers are composed of two parts, a front end and a back end. The compiler front end 

receives computer programs as input. These computer programs are normally written in high level 
programming languages, such as Pascal, C, and Ada. 

The compiler front end scans, parses, and performs semantic analysis on the computer program, in 
other words, the front end is responsible for language dependent processing of the computer program. After 
40 all language dependent processing is complete (and if no errors have been found), the front end generates 
a compiler intermediate representation of the computer program. The compiler intermediate representation 
is analogous to an assembly language representation of the computer program. 

Compiler back ends receive the compiler intermediate representations as input and convert the 
compiler intermediate representation to object code representations for specific computer platforms. 
45 The object code representations are is then converted to executable code representations by linkers on 
the target compiler platforms. Linkers are not part of compilers. 

Normally, the front end generates compiler intermediate representations in a machine dependent 
manner. This is particularly true for operations involving memory allocation, data type conversion, and 
include file processing. Thus, compffer intermediate representations are normally machine dependent and 
50 thus unsuitable as an ANDF. 

if, however, the front end operates in a machine independent manner, and if the resulting compiler 
intermediate representation makes no assumptions about the specific architectural features of particular 
computer platforms, then the compiler intermediate representation is architecturally neutral Thus, such a 
compiler intermediate representation is an ANDF. 
55 Under the ANDF Using Compiler Intermediate Representation approach, therefore, an architecture 
neutral compiler intermediate representation is used as the software distribution format. ANDF Compiler 
front ends (or "ANDF Producers") are located on native computer platforms and ANDF Compiler back ends 
(or ?, ANDF Installers") are located on target computer platforms, 
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ANDF Producers create compiler intermediate representations of computer programs. These compiler 
intermediate representations, being architecturally neutral, are distributed to heterogeneous target computer 
platforms. ANDF Installers install the compiler intermediate representations on target computer platforms. 
An ANDF Interpreter may be substituted for the ANDF Installer. An ANDF Interpreter directly executes 
s intermediate instructions without first translating them to executable code. 

The ANDF Using Compiler Intermediate Representation approach solves the security problems of the 
first and second ANDF approaches. High-level source code constructs, which encompass the computer 
program's proprietary secrets, are represented with difficuft-to-read low-level instruction sequences. Also, 
low-level instruction sequences are represented by strings of numbers, rather than mnemonics. 
w The ANDF Using Compiler Intermediate Representation approach solves the inherent problems of the 
third ANDF approach, since the ANDF Using Compiler Intermediate Representation approach is truly 
architecture neutral (i.e., machine independent). 

Thus, the ANDF Using Compiler Intermediate Representation approach has no inherent flaws. This 
ANDF approach, however, presents many difficult design and implementation problems. 
75 Specifically, a compiler intermediate language must be defined so that the ANDF Producer, based on 
this definition, can produce compiler intermediate representations that are free from the machine depen- 
dencies which are normally produced by the application of inherently machine dependent computer 
operations, such as memory allocation, data type conversion, data folding, and include file processing. 
These operations are described below. 
20 Additionally, the compiler intermediate language must be defined so that the ANDF installer, based on 
this definition, can receive the compiler intermediate representation as input and produce executable code 
for any target computer platform. 

Memory allocation operations are inherently machine dependent because they depend on a particular 
computer platform's specification for data alignment; data sizes, and data attributes. For example, some 
25 computer platforms align integers so that the most significant byte is in the lowest memory address, while 
others align integers so that the least significant byte is in the lowest memory address. Also, some 
computer platforms specify integers as being signed and 32 bits wide, while others specify integers as 
being unsigned and 16 bits wide. 

Memory allocation operations are also dependent upon a particular computer platform's data repre- 
30 sentation scheme. For example, for computer platforms which support the ASCII character set, the string 
"HELLO" would be represented in memory as the following sequence of hexidecimai bytes: 48 45 4C 4C 
4F. However, the string "HELLO" would be represented as a different sequence of hexidecimal bytes in 
computer platforms which support the EBCDIC character set 

Data type conversion and data folding operations are also inherently machine dependent. For example, 
35 in converting a signed short integer (with a value of less than zero) to a standard sized signed integer, some 
computer platforms will insert all zeroes in front of the most significant digit. Other computer platforms will 
insert all ones. 

Also, the resulting data type of an expression is not always apparent. For example, in the expression y 
= x + 20000 + 17000, some computer platforms may represent the result of 20000 * 17000 as an 
40 integer, whiie others may represent the result as a long integer. 

Many high level languages, such as C, allow computer programmers to add predefined or often-used 
code into their programs through the use of include files. Often, those include files include macro 
operations, which are similar to software procedures and functions. Macros defined on one computer 
platform may not exist or may exist in different forms on other computer platforms. 
45 Many of the OSF proposals were based on the ANDF Using Compiler Intermediate Representation 

approach. For the most part, however, the OSF proposals were not completely architecture neutral because 
they failed to address all the implementation problems described above. 

A proposal describing the present invention was submitted in response to the OSF RFT. 

The present invention represents an ANDF specification based on the ANDF Using Compiler Intermedin 
so ate Representation approach. Unlike other ANDF specifications, the present invention is based on the 
Ucode compiler intermediate language. Additionally, the ANDF specification defined by the present 
invention is completely architecture neutral 

SUMMARY OF THE INVENTION 

55 

The present invention is directed to a computer software compiler system and method for distributing a 
machine independent computer program, created on a native computer platform, to heterogeneous target 
computer platforms. Specifically, the present invention is directed to an architecture-neutral distribution 
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format (ANDF) computer software compiler (hereinafter called an "ANDF Compiler"). 

ANDF Compilers are composed of two components, an ANDF Producer and an ANDF Installer. The 
ANDF Producer and the ANDF installer are analogous to a front end and a back end, respectively, of a 
convention computer software compiler. 
5 The ANDF Producer and the ANDF Installer reside on heterogeneous computer platforms. Specifically, 

the ANDF Producer resides on a producer Site or a native computer platform, and the ANDF installer reside 
on a install site or a target computer platform. 

The ANDF Producer receives the machine independent computer program as input and generates a 
compiler intermediate representation of the machine independent computer program. The ANDF Producer 
io generates the compiler intermediate representation according to an HPcode-Plus compiler intermediate 
language, such that the compiler intermediate representation is composed of HPcode-Plus instructions from 
the HPcode-Plus compiler intermediate language. 

In generating the compiler intermediate representation according to the HPcode-Plus compiler inter- 
mediate language, the ANDF Producer is operating in an architecture neutral, or machine independent, 
is manner. 

Specifically, according to the HPcode-Plus compiler intermediate language, the ANDF Producer defers 
machine dependent decisions concerning inherently machine dependent computer operations to the ANDF 
Installer. Therefore, the compiler intermediate representation which is generated by the ANDF Producer is 
free from the machine dependencies which are normally produced by the application of inherently machine 
20 dependent computer operations, such as memory allocation, data type conversion, data folding, and include 
file processing. 

Therefore, the compiler intermediate representation is architecture neutral and represents an architec- 
ture neutral distribution format (ANDF). 

In the present invention, the compiler intermediate representation which is generated by the ANDF 
25 Producer is distributed to the install sites. The install sites represent heterogeneous target computer 
platforms. 

The ANDF installers, which reside on the install sites, receive the compiler intermediate representation 
as input and generate object code representations of the machine independent computer program, tn 
generating object code, the ANDF Installers make the machine dependent decisions which were deferred 
30 from the ANDF Producer. Thus, the object code representations are architecture dependent, or machine 
dependent, on the target computer platforms. 

Thus, as is clear from the above, the machine independent computer program can be compiled using 
the ANDF Compiler of the present invention to produce the compiler intermediate representation which is 
free from any machine dependencies. The compiler intermediate representation represents an architecture 
35 neutral distribution format and can be distributed to heterogeneous target computer platform. Distribution is 
enhanced since a single version of the machine independent computer program can be used, with no 
modifications, on heterogeneous target computer platforms. 

Further features and advantages of the present invention will be apparent from the ensuing description 
with reference to the accompanying drawings to which, however, the scope of the present invention is in no 
40 way limited, 

B Rt EF DESCRIPTION OF THE DRAWINGS 

FIG. 1 is a high-level structural and operational block diagram of conventional computer software 
45 compilers. The square blocks represent modules and the arrows represented operation and data flow. 

FIG. 2 is a high-level structural and operational block diagram of a preferred embodiment of the present 
invention. The square blocks represent modules and the arrows represented operation and data flow. 
FIG. 3 comprises FIGS. 3A> 3B, 3C, and 3D. 

FIGS, 3A> 3B, and 3C are tables listing the instruction classes, instruction mnemonics, operational code 
so (opcode) hex values, and descriptions of the HPcode-Plus compiler intermediate language instruction set for 
the ANSI-G computer programming language. 

Figure 3D illustrates the manner in which Figures 3A, 3B, and 3C are connected. 

FIGS. 4A - 4G are all associated with instruction classes, instruction mnemonics, operational code 
(opcode) hex values, and descriptions of the HPcode-Plus compiler intermediate language instructions for 
55 programming languages other than the ANSI-C computer programming language. 

FIG. 4A is a table listing the symbolic identifiers and descriptions of additional HPcode-Plus predefined 
data types which support computer programming languages other than ANSl-C. 

FIG, 4B is a table listing additional <sym kind) values for the SYM HPcode-Plus instruction which 
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support computer programming languages other than ANSI-C. 
FIG. 4C comprises FIGS. 4C1 , 4C2, and 4C3. 

FIGS. 4C1 and 4C2 are tables listing additional HPcode-Plus operators which support computer 
programming languages other than ANSI-C. 
5 FIG. 4C3 illustrates the manner in which FIGS. 4C1 and 4C2 are connected. 

FIGS. 40, 4E, 4F, and 4G are tables Nsting additional HPcode-Plus operators which support the ADA, 
COBOL, FORTRAN, and PASCAL, respectively, computer programming languages. 

FIG. 5 is a table listing HPcode-Plus predefined data types for the ANSI-C computer programming 
language. 

70 FIG. 6 is a table showing the mapping from ANSI-C data types to HPcode-Plus data types. 

FIG. 7 is a table listing values of <sym kind) of a HPcode-Plus instruction SYM for defining data types 
other than HPcode-Plus predefined data types. 

FIG, 8 is a sequence of HPcode-Plus instructions which show the structure of a HPcode-Plus object file. 
FIG. 9 is a table listing predefined symbolic identifiers for HPcode-Plus predefined data types for the 
75 ANSI-C computer programming language. 

FIG. 10 is a table which lists values of <sym kind) of the HPcode-Plus instruction SYM. 
FIG. 11 is a structural and operational block diagram of a preferred embodiment of the ANDF Producer. 
The square blocks represent modules and the arrows represented operation and data flow. 

FIG. 12 is a structural and operational block diagram of a preferred embodiment of a compiler 
20 component of the ANDF Producer. The square blocks represent modules and the arrows represented 
operation and data flow. 

FIG. 13 is a structural and operational block diagram of a preferred embodiment of the ANDF Installer. 
The square blocks represent modules and the arrows represented operation and data flow. 

FIG. 14 is a partial computer program listing of an example machine independent ANSI-C computer 
25 program. 

FIG. 15 comprises FIGS. 15A, 15B, 15C f 15D, and 15E. 

FIGS. 15A, 15B, 15C, and 15D show a sequence of HPcode-Plus instructions which represents a 
HPcode-Plus translation of the partial computer program listing of FIG. 14. 

FIG. 15E illustrates the manner in which FIGS. 15A, 15B : 15C, and 15D are connected. 

30 
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1. ANDF Compiler 

The present invention \s directed to the standards being promulgated by ANSI for the C programming 
language {i.e., ANSi-C} and by the Open Software Foundation (OSF) for Unix computer platforms, it should 
55 be understood, however, that the present invention is not limited to the ANSI and OSF standards. 

The present invention, in either its present form or in the forms now contemplated, is applicable to 
computing environments which use deviations, modifications, and extensions of the ANSI and OSF 
standards. The scope of the present invention with respect to the ANSI and OSF standards is more fully 
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described in the following text. 

As shown in Figure 1, a conventional compiler 106 is logically divided into two parts, a compiler front 
end 108 and a compiler back end 116. The compiler front end 108 receives as input a computer program 
source code 102 as input. The computer program 102 is ordinarily written in a high-level computer 
5 programming language such as Pascal, C, and Ada. 

The compiler front end 108 Is responsible for the language processing of computer programs, such as 
scanning, parsing, and semantic analysis, Following the completion of all language processing, the compiler 
front end 108 translates the computer program source code 102 into a compiier intermediate representation 
112. The compiler intermediate representation 112 is written in a compiler intermediate language, such as 
io Pcode and Ucode. 

The compiler back end 116 receives as input the compiler intermediate representation 112 and 
generates object code 120 for a target computer platform {not shown). The target computer platform is the 
computer platform where the compiler back end 116 resides. The object code 120 is written in a particular 
machine language of the target computer platform. 

75 Ordinarily, the compiler front end 108 operates in a machine dependent, or architecture dependent, 
manner. Thus, the compiler intermediate representation 112, which is generated by the compiler front end 
108, is usually dependent upon the computer architecture of the native computer platform {i.e., the 
computer platform where the compiler front end 108 resides). 

The present invention is a significant improvement from the conventional compiier 106 shown in Figure 

20 1. The improvement of the present invention is achieved by using a HPcode-Plus compiler intermediate 
language as the compiler intermediate language. The HPcode-Plus compiler intermediate language (or 
simply, HPcode-Plus) is an improvement upon conventional compiler intermediate languages, such as 
Pcode and Ucode, in that HPcode-Plus is architecture neutral. As such, compilers which are based on the 
HPcode-Plus compiler intermediate language operate in an architecture neutral, or machine independent, 

25 manner. 

Figure 2 presents an overview of a preferred embodiment of the present invention. Included in Figure 2 

is a high-level block diagram of an architecture neutral distribution format compiler 234 of the present 

invention (i.e., an ANDF compiler). The ANDF compiler 234 shown in Figure 2 is based on the HPcode-Plus 

compiler intermediate language. 
30 In the preferred embodiment of the present system, logic for the ANDF Compiler 234 is stored in a 

computer program. The computer program is stored in a computer readable medium, such as a magnetic 

tape, a magnetic disk, and a read only memory {ROM). 

Like conventionai compilers 106, the ANDF compiier 234 of the present invention has a front end. With 

the ANDF compiler 234, however, the front end is called an ANDF Producer 208. The ANDF compiler 234 
35 also has one or more back ends. In the preferred embodiment of Figure 2 E two back ends, called ANDF 

Installers 218 and 228, are shown. 

The ANDF Producer 208 resides on a native computer platform 206. It should be noted that the native 

computer platform 206 is also called a producer site. The one or more ANDF Installers 218 and 228 reside 

on install sites 216 and 226, respectively, which are also called target computer platforms. It should be 
40 noted that the producer site 206 and install sites 216, 226 may or may not represent the same computer 

platform. 

The ANDF Producer 208 and the ANDF Installers 218, 228 can operate either independently, as two 
separate computer programs, or together, as two phases of a single computer program. 

As shown in Figure 2, the ANDF Producer 208 receives the ANSI-C source code of machine 
45 independent computer programs 202. it should be understood, however, that the present invention is not 
limited to support for only ANSl-C source language programs. As described below, support for other high- 
level languages is contemplated. 

Machine independent computer programs 202 are computer programs which are composed of instruc- 
tions. These instructions include high-level source statements and expressions. 
50 Machine independent computer programs 202 do not make assumptions on system specific features, 
such as memory architectures and register architectures. Machine independent computer programs 202 
also do not contain references to system specific functions, such as non-standard operating system function 
calls. Machine independent computer programs 202 may contain references to standard object-like macros, 
function-like macros, and data type definitions from standard header files. Machine independent computer 
55 programs 202 may also contain references to standardized function calls. The standard header files and 
standardized function calls are defined by a language standard, such as ANSI-C. 

The ANDF Producer 208 operates in an architecture neutral, or machine independent, manner 
according to the HPcode-Plus compiler intermediate language. Thus, in translating the ANSI-C source 
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language program 202 to a compiler intermediate representation 212, the ANDF Producer 208 makes no 
assumptions about the architecture of the target computer platforms 216 and 226. Thus, the compiler 
intermediate representation 212 generated by the ANDF Producer 208 is architecture neutral, or machine 
independent, and represents an architecture neutral distribution format (ANDF). 
5 The compiler intermediate representation 212 is distributed to the target computer platforms 216 and 

226. The ANDF Installers 218 and 228, which reside on the target computer platforms 216 and 226, 
respectively, translate the compiler intermediate representation 212 to object code representations 222 and 
232, 

In an alternative embodiment of the present invention, ANDF installers 216, 226 are replaced by ANDF 
w Interpreters (not shown in Figure 2). The ANDF Interpreters directly execute the compiler intermediate 
representation 212 without first translating the compiler intermediate representation 212 to object code 
representations 222, 232. 

As noted above, the HPcode-Plus compiler intermediate language is used as the compiler intermediate 
language in the preferred embodiment of the present invention. Thus, the ANDF Producer 208 writes the 
75 compiler intermediate representation 212 in the HPcode-Plus compiler intermediate language. 

The HPcode-Plus compiler intermediate language is an improvement upon HPcode, which was an 
improvement upon U-Code. U-Code is a compiler intermediate language which was originally used for 
distributing a Pascal compiler to the CRAY-1 and S-1 computer platforms. It was developed by Stanford 
and the University of California at San Diego. U-Code, however, was not architecture neutrai and couid only 
20 support Pascal and Fortran source language programs. 

HPcode is also a compiler intermediate language. It was based on U-Code, but its instruction set was 
expanded to support other high-level languages, including Pascal Fortran. Ada, Cobol, RPG, Business 
Basic, an internal Algol-like language, and a fourth generation language called HP-Transact. 

As noted above, the HPcode-Plus compiler intermediate language is an improvement upon HPcode, 
25 and upon all conventional compiler intermediate languages, in that HPcode-Plus is architecture neutral As 
such, compilers which are based on the HPcode-Plus compiler intermediate language, such as the ANDF 
compiler 234 of the present invention, operate in an architecture neutral, or machine independent, manner. 

The HPcode-Plus compiler intermediate language is a further improvement upon HPcode, in that 
HPcode-Plus supports the C programming language. 
30 The following sections describe the present invention in more detail. 

Section 2 describes the HPCode-Pius compiler intermediate language, which is the compiler intermedi- 
ate language of the present invention. 

Section 3 describes the ANDF Producer 208 of the present invention. 
Section 4 describes the ANDF Installer 218, 228 of the present invention. 
35 Some aspects of the present invention can be implemented using existing compiler technology. 

However, modifications upon existing compiler technology are required to achieve the improvements of the 
present invention. The discussions in Sections 2, 3, and 4 focus on these modifications upon existing 
compiler technology. For a general discussion of existing compiler technology, see Compilers, Principles, 
Techniques, and Tools by Alfred V. Aho, Ravi Sethi, and Jeffrey D. Uilrnan (Addison Wesley 1986)Twhich is 
40 incorporated in its entirety herein by reference. 

As it presently exists, the HPcode-Plus compiler intermediate language can be used as the compiler 
intermediate language for architecture neutral C compilers on OSF computer platforms, such as the ANDF 
compiler 234 of the present invention. Thus, the descriptions of the preferred embodiment of the present 
invention in Sections 2, 3, and 4 are, for the most part, focused on this computing environment. 
45 It should be understood, however, that the present invention is not restricted to this computing 

environment. 

Since it is an improvement of HPcode, the HPcode-Plus compiler intermediate language has a rich 
instruction set for supporting other high-level languages, such as Pascal, Fortran, Ada, Cobol, RPG, 
Business Basic, an internal Algol-like language, and a fourth generation language called HP-Transact. It is 
so contemplated to modify HPcode-Pfus to support these languages in an architecture neutral manner. 

Additionally, the compiler intermediate representations 212 produced by ANDF compilers 234 should 
operate on any computer platform, provided that (1) the source language program 202 was written in a 
machine independent manner using standardized function calls to a run-time library, and (2) appropriate 
ANDF Installers 218, 228 exist on the target computer platforms 216, 226. 

55 

2, HPcode-Plus 

In the preferred embodiment of the present invention, the HPcode-Plus compiler intermediate language 
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is used as the compiler intermediate language, 

HPcode-Plus is an improvement upon conventional compiler intermediate languages in that HPcode- 
Pius is architecture neutral. As such, compilers which are based on the HPcode-Plus compiler intermediate 
language, such as the ANDF compiler 234 of the present invention, operate in a architecture neutral, or 
5 machine independent, manner. 

Features of the HPcode-Pius compiler intermediate language are described in this section. HPcode-Plus 
instructions are shown with all letters capitalized. 

Other features of HPcode-Plus are described as necessary in Sections 3 and 4 of this document. When 
reading these sections, it may be helpful to refer to Figure 3, which presents a fist of the HPcode-Plus 
w compiler intermediate language instructions for ANSI-C. 

Virtua ^ Machine Model (Expression Stack Model) 

The HPcode-Plus compiler intermediate language is very similar to assembly language for a HPcode- 
75 Plus virtual (i.e., fictional) computer platform. Correspondingly, compiler intermediate representations written 
in the HPcode-Plus compiler intermediate language are very similar to assembly language programs for the 
HPcode-Plus virtual computer platform. 

Referring to Figure 2 y for example, the ANDF Producer 208 translates the source code 202 into its 
equivalent assembly language representation 212. 
20 The ANDF Producer 208, however, does not generate the assembly language representation 212 for its 

native computer platform 206. Rather, the ANDF Producer 208 generates the assembly language repre- 
sentation 212 for the HPcode-Plus virtual computer platform. The HPcode-Plus compiler intermediate 
language represents the assembly language for the HPcode-Plus virtual computer platform. 

The ANDF Installer 218, 228 receives the compiler intermediate representation 212, which represents 
25 assembly language for the HPcode-Plus virtual computer platform, and generates the object code 222, 232 
for its target computer platform 216, 226. 

The HPcode-Plus virtual computer platform contains an expression stack and a memory. Most HPcode- 
Plus instructions receive their arguments from and push their results to the expression stack. A data type is 
associated with each data object on the expression stack. 
30 HPcode-Plus instructions do not directly manipulate arbitrary expression stack elements. At most, 
HPcode-Plus instructions manipulate only the top N elements of the expression stack, where N is defined 
for each HPcode-Plus instruction. 

HPcode-Plus instructions DUP, SWP, and ROT manipulate the top elements on the expression stack 
without altering their values. A HPcode-Plus instruction DEL deletes the top element on the expression 
35 stack. 

Several HPcode-Plus instructions are provided for moving data between the expression stack and the 
memory, including HPcode-Plus instructions LOD and ILOD for direct and indirect load, HPcode-Plus 
instructions STR and ISTR for direct and indirect store, and HPcode-Plus instruction iNST for indirect non- 
destructive store. 

40 !n addition, data object addresses, labels, and procedures are loaded on the expression stack with 

HPcode-Plus instructions LDA, LDL, and LDP, respectively. HPcode-Plus instructions LDC and LCA are 
used to load constants and constant addresses on the expression stack. 

The expression stack may not physically exist on target computer platforms 216, 226. For example, if 
target computer platforms 216, 226 are register-based, then the expression stack may be modeled in 

45 registers. 

Care must be taken by the ANDF Installers 218, 228 to preserve the semantics of the expression stack. 
Values loaded onto the expression stack are "copied" onto the expression stack. HPcode-Plus instructions 
do not alter values already on the expression stack. 

Certain restrictions are enforced concerning the use of the expression stack. Branching and label 
so HPcode-Plus instructions require the expression stack to be empty, This relieves the ANDF installer 218, 
228 from having to determine all possible jump sources for each label. 

HPcode-Plus procedure calls may occur when the expression stack is empty. Elements which are on 
the expression stack when a HPcode-Plus instruction MST is executed will not be visible to the called 
procedure but will become visible again upon return. 

as 

2,2 Memory Model 

HPcode-Plus defines a memory model in which the memory is divided into 4 areas: Static memory, 
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Local memory, Constant memory, and Parameter memory. Data objects in each memory area can have 3 
attributes associated with them: Constant attribute, Register attribute, and Volatile attribute. 

in the architecture neutral environment of the present invention, the ANDF Producer 206 makes no 
assumptions concerning the manner in which data objects are mapped into the memories of target 
5 computer platforms 21 6 f 226. A HPcode-Plus instruction SYM is provided to defer actual memory allocation 
to the ANDF Installers 218, 228. 

The ANDF Producer 208 uses the HPcode-Plus instruction SYM to give a unique symbolic identifier to 
each data object and data type. The only exception to this rule is that the symbolic identifier of data types 
and data objects in local scopes can be reused . 
w The ANDF Producer 208 also uses the HPcode-Plus instruction SYM to associate a memory type and 

attribute (i.e., Constant, Register, and Volatile) with each data object. 

HPcode-Plus memory reference instructions access memory through the symbolic identifiers of data 
objects defined by the SYM HPcode-Plus instruction. These HPcode-Plus memory reference instructions 
include LDA and LCA to load an address of an HPcode-Plus data object onto the expression stack. Also, 
75 HPcode-Plus contains instructions which manipulate memory indirectly, such as the string instructions. 

The ANDF Installers 218, 228 map data objects into the memories of their target computer platforms 
216, 226. Such mapping depends on the memory type and attribute associated with each data object. A 
description of the memory types and attributes is presented in the following paragraphs. 

Data objects with the Static memory type maintain their values from one invocation of a procedure to 
20 the next. Static memory can be subdivided into global static memory, imported static memory, exported 
static memory, and procedure static memory. Variables mapping into these memories include file static 
variables, imported static variables, exported static variables, and procedure (or local) static variables, 
respectively. 

Data objects with the Local memory type do not maintain their values from one invocation of a 
25 procedure to the next. These objects are allocated to the Local memory area. Each procedure receives one 
Local memory area. 

For languages which do not support nested level procedures, such as ANShC, local data objects can 
only be referenced by the defining procedure. 

For languages supdistributing nested ievel procedures, such as Pascal, local data objects can be 
$o referenced by the defining procedure or its lower level nested procedures. For these languages, the 
scoping rules are equivalent to those in Pascal. 

Data objects with the Parameter memory type are allocated in the Parameter memory area. Each 
procedure receives one Parameter memory area. 

For languages which do not support nested procedures, such as ANSI C, variables in the Parameter 
35 memory area may be referenced only by the defining procedure. 

For languages which support nested procedures, such as Pascal, variables in the Parameter memory 
area may be referenced from outside the defining procedure subject to the Pascal scoping rules. This area 
is allocated by the calling procedure. 

All HPcode-Plus constants reside in the Constant memory area, in addition, any data objects with the 

40 Constant memory attribute defined by the SYM HPcode-Plus instruction of KIND MODIFIER are allocated 

in the Constant memory area. 

The ANDF Installers 218, 228, if possible, treat the Constant memory area as read-only. The ANDF 
Producer 208, however, does not assume that the target computer platforms 216, 226 can support read- 
only memory. Assignment to the Constant memory area yields undefined behavior. 
45 The Register attribute serves as a hint to the ANDF Installers 218, 228 that the associated data object 

should be allocated in fast cache memory. The ANDF Installers 218, 228, however, are not obliged to honor 
the request. Loading an address of a variable with the register attribute set can automatically turn off the 
register attribute. 

so 2.3 Memory Allocation and Data Types 



The ANDF Producer 208 makes no assumptions concerning the manner in which data objects are 
mapped into the memories of target computer platforms 216, 226. Instead, the ANDF Producer 208 satisfies 
memory requests through the SYM HPcode-Plus instruction. 
55 Actual memory allocation is performed by the ANDF InstaNers 218, 228. The actual size and alignment 

of each data object is determined by ANDF installers 218, 228, based on the data type specified in the 
SYM HPcode-Plus instruction. 

HPcode-Plus defines predefined data types. A list of the HPcode-Plus predefined data types is 

11 



SNSDOC3D: <EP.. 



04635B3A2....I....> 



EP 0 463 583 A2 



presented in Figure 5. With minor differences, the HPcode-Pius predefined data types map into the 
corresponding data types in ANSI-C. The mapping of ANShC data types to HPcode-Plus predefined data 
types is presented in Figure 6. 

The HPcode-Pius predefined data types have unique predefined symbolic identifiers. The HPcode-Plus 
5 predefined data types are the only data types that need not be defined by the SYM HPcode-Pius 
instruction. They are the building blocks for user-defined data types. 

The user-defined data types, which represent alt data types besides the HPcode-Plus predefined data 
types, are defined using the SYM HPcode-Plus instruction with the <sym kind) parameter equal to one of 
the type values listed in Figure 7, 
70 The ANDF Installers 218, 228 must ensure that their memory allocation schemes are consistent with 
those of a compiler on the native computer platform 206. 

2.4 HPcode-Plus Object File 

75 The compiler intermediate representation 212 produced by the ANDF Producer 208 is stored in a 
HPcode-Plus Object file 1160 (Figure 11), 

The HPcode-Plus Object file 1160 is a file containing a sequence of HPcode-Plus instructions in ASCI! 
form which follow certain rules of form. The HPcode-Plus Object file 1160 is also referred to as a 
compilation unit. 

20 As shown in Figure 11, several HPcode-Plus Object files 1150, 1160 can be archived or linked by an 
Arcliiver/Linker 1154 to produce a single HPcode-Plus Archive file 1158 or Linked HPcode-Plus File 1170. 
The format of the HPcode-Plus Object file 1150, 1160 is shown in Figure 8. 

HPcode-Plus instruction names are shown in Figure 8 in text form for readability only. In actual 
HPcode-Plus Object files 1150, 1160, numeric opcodes are used instead. 
25 Instructions are delimited by ASCII new line characters. All integers, including opcodes, are represented 
by hexadecimal literals to minimize the size of the HPcode-Plus Object file 1150, 1160. 

Within a line, fields are delimited by one or more blanks. An 'opcode' field is first, followed by 2ero or 
more 'operand' fields. Operand fields consist of integers, quoted strings, labels, real numbers ; digit strings 
representing sets and or followed by integers representing macro arguments and SYM symbolic ids, 
30 respectively. Quoted strings are delimited by double quotes (an internal quote is represented by two double 
quotes in a row). 

Each ENT/END HPcode-Plus instruction sequence denotes the code of a procedure. SYM HPcode-Pius 

instructions within a pair of Kl N D FU NOTION and KIND END SYM HPcode-Pius instructions represent 

the data declarations of that procedure. 
35 For languages which allow multiple entry points, more than one ENT HPcode-Plus instruction appears 
before the END HPcode-Pius instruction. The first ENT HPcode-Plus instruction signals the primary entry 
point and defines the start of the scope of a procedure. The END HPcode-Plus instruction signals the end 
of the entire procedure. 

!f the HPcode-Plus Object file 1150, 1160 contains the procedure which serves as the program entry 
40 point. Then the HPcode-Plus Object file 1150, 1160 is specially marked with an OPTN HPcode-Plus 
instruction. Execution of an HPcode-Plus computer program begins with the program entry point procedure. 
Each HPcode-Plus instruction is executed in sequence unless an error occurs or a HPcode-Plus instruction 
is executed which transfers control. 

If the source computer program 202 contains nested procedures (Pascal, Cobof or Ada), the outer level 
45 procedure and ail its inner procedure must appear in the same HPcode-Plus Object file 1 150, 1160. 

2.5 HPcode- Plus Instruction Set for ANSI-C 

As it presently exists, HPcode-Pius can be used as the compiler intermediate language for architec- 
so furally neutral C compilers on OSF computer platforms. It should be understood, however, that the present 
invention is not restricted to this computing environment. 

As described above, HPcode-Plus has a rich instruction set for supdistributing high-level languages 
other than C, such as Pascal, Fortran, Ada, Cobol, RPG, Business Basic, an internal Algol-like language, 
and a fourth generation language called HP-Transact. It is contemplated to modify HPcode-Plus to support 
55 these languages in an architecture neutral manner. 

Addttionally, the compiler intermediate representations 212 produced by ANDF compilers 234 should 
operate on any computer platform, provided that (1) the source computer program 202 was written in a 
machine independent manner using standardized function calls to the run-time library, and (2) appropriate 
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ANDF installers 218, 228 exist on the target computer platforms 216, 226, 

The HPcode-Plus instruction set for ANSI-C is presented in Figure 3. These HPcode-Plus instructions 
are described in the following sections. In these sections, expression stack elements and mandatory passed 
parameters are denoted by "<>". Optional passed parameters are denoted by "[]". The abbreviation "op 1 ' 
5 represents "operand". 

In its present form, HPcode-Plus does not support parallelism and vectorization. Currently, all HPcode- 
Plus instructions operate on scalar items. However, HPcode-Plus is capable of carrying sufficient informa- 
tion to support vector operations. Thus, HPcode-Plus can easily be enhanced to support both parallelism 
and vectorization, 

io Existing HPcode-Plus instructions which are required to support other high-level languages, but which 
are not yet completely architecture neutral, are presented in Figure 4. 

2.5,1 - ACVT - Arithmetic ConVerT 

75 The syntax of HPcode-Plus instruction ACVT is presented below: 
ACVT 

ACVT is used to convert operands to a known data type. ACVT pops <op2) and <op1> from the 
expression stack. ACVT performs data type conversions on <op2) and <op1> to prepare <op2) and <op1) for 
arithmetic processing. After conversion, <op2) and <op1> are pushed onto the expression stack. 
20 Conversion rules are language specific, HPcode-Plus instruction LANGUAGE OPTN indicates which set 
of rules to use. For example, the usual arithmetic conversions for ANSi-C are: 

o If either operand has type long double, the other operand is converted to long double, 
o Otherwise, if either operand has type double, the other operand is converted to double, 
o Otherwise, if either operand has type float, the other operand is converted to float, 
25 o Otherwise, if one operand has type long int and the other has type unsigned int then if a long int can 
represent all values of an unsigned int, then the operand of type unsigned int is covered to long int; if 
a long int cannot represent all the values of an unsigned int, both operands are converted to unsigned 
long int, 

o Otherwise, if either operand has type long int, the other operand is converted to long int. 
so o Otherwise, if either operand has type unsigned int, the other operand is converted to unsigned int. 
o Otherwise, both operands are converted to type int. 

The ANDF Installers 218, 228 use a general conversion table to implement the conversion rules. This 
conversion table is implemented as a two dimension conversion table as follows: 





TYPE_CHAR 


TYPEUNSCHAR 




TYPE_CHAR 


TYPEINT 


TYPEINT 




TYPE_UNS_CHAR 


TYPEINT 


TYPEINT 













so Each language has a unique conversion table which resides on each target computer platform 216, 226. 
2.5.2. ADD - ADD 



The syntax of HPcode-Pius instruction ADD is presented below: 
55 ADD 

ADD pops <op1> and <op2> from the expression stack. The addition <op1> + <op2> is performed to 
produce a result. The result, having the same data type as <op1> and <op2>, is then pushed on the 
expression stack. 
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2.5.3 AND - logica! AND 

The syntax of HPcode-Plus instruction AND is presented below: 
AND 

5 AND pops <op1> and <op2> from the expression stack. A logical AND operation, (op1> AND <op2> f is 

performed to produce a result. The result, having the same data type as <op1> and <op2>, is then pushed on 
the expression stack, 

A bitwise AND is performed when <op1> and <op2> are integers or characters. That is, corresponding bits 
in <op1> and <op2> are ANDed to produce (result). 

10 

2.5.4. CEND - Conditional evaluate END 

The syntax of HPcode-Plus instruction CEND is presented below: 
CEND 

15 This HPcode-Plus instruction marks the end of a conditionally evaluated instruction sequence begun by 

a matching HPcode-Plus instruction CEXP. 

The CEND HPcode-Plus instruction does not manipulate the expression stack. The item that is on top 

of the expression stack is the result produced by the matching CEXP instruction. The type of the item on 

top of the stack must be the same as the data type of the two CEXP clauses. 
20 The CEND HPcode-Plus instruction can only be used to terminate the most recent CEXP HPcode-Plus 

instruction. It is an error if there is no preceding conditional instruction. 

2.5.5. CEVL - Conditional EVaLuate 

25 The syntax of HPcode-Plus instruction CEVL is presented below: 
CEVL 

This HPcode-Plus instruction leaves the expression stack unchanged. CEVL acts as a delimiter between 
two parts of a conditional expression. For example, two CEVLs are required with each CEXP instruction. 
One CEVL separates <boolean value) from <true expression), and the other separates <faf$e expression) from 
30 (true expression). 

Stack items on the expression stack at the time of CEVL are not accessed until the conditional 
expression is terminated with a CEXP instruction, 

2.5.6. CEXP - Conditionally evaluate EXPression 

35 

The syntax of HPcode-Plus instruction CEXP is presented below: 
CEXP 

This HPcode-Plus instruction pops a boolean operand {boolean op) off the top of the expression stack. 
If (boolean op) is FALSE, then control is passed to a matching CSEP instruction. An item that is on top of 
40 the expression stack when a matching CEND instruction is encountered is treated as a result of the CEXP 
instruction. 

If the item popped off the top of the expression stack is TRUE, then HPcode-Plus instructions up to the 
matching CSEP are evaluated. Control is then passed to the matching CEND HPcode-Plus instruction. The 
item that is on top of the stack when the matching CSEP instruction is encountered is treated as the result 
45 of the CEXP HPcode-Plus instruction. 

The HPcode-Plus instructions between the CEXP and the matching CSEP HPcode-Plus instructions 
represent the true clause of the conditional evaluation. The HPcode-Plus instructions between the CSEP 
and the matching CEND HPcode-Plus instructions represent the false clause of the conditional evaluation. 

Both the true clause and the false clause must either result in zero or one item being pushed onto the 
so expression stack. The data type of the resulting item pushed on to the expression stack by either clause 
must match and corresponds to the data type of the result of the CEXP HPcode-Plus instruction. 

It is possible for the true and false clauses to not leave any result on the stack, in particular, this 
happens with the ANSI-C conditional expression operator if the true and false clauses are of type void. 
There is no <result) pushed to the expression stack in this case. 
55 It is an error to specify the CEXP HPcode-Plus instruction without specifying matching CSEP and 
CEND HPcode-Plus instructions. It is also an error for either the true clause or the false clause to reference 
items pushed on the expression stack outside the respective clauses. 
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2.5.7. CLDC - C LoaD Constant 

The syntax of HPcode-Plus instruction CLDC is presented below: 
CLDC <flag> (constant value) 
5 CLDC converts (constant value) to a data type indicated by <flag> to produce a result. CLDC then 

pushes the result onto the expression stack. 

The values and corresponding data types of <flag> are presented below, 

<J0 ag> Data Types 

0 TYPEINT, TYPELONGINT, TYPE_UNS_LONG I NT 

1 TYPE__INT , TYPE_UNS_INT, TYPE LONG INT, 
TYPE JJNS_L0NG INT 

2 TYPE_UNS_INT, TYPEJJNS LONG INT 
76 3 TYPE__LONGINT, TYPE UNS LONGINT 

4 TYPE UNS LONG I NT 



If <f!ag> is 0, then the ANDF Installer 218, 228 converts {constant value) to TYPE !NT ; if possible, if it is 

20 not possible, then the ANDF Installer 218, 228 converts (constant value) to TYPE LONGINT, if possible, if 

it is not possible, then the ANDF installer 218, 228 converts (constant value) to TYPE UNS LONGINT. 

The ANDF Producer 208 does not know what the ultimate data type of (constant value) will be. Thus, 
the ANDF Producer 208 cannot use CLDC prior to arithmetic operations. For arithmetic operations, ANDF 
Producers must use the AGVT HPcode-Plus instruction. 

25 

2.5.8. COMM - COMMent Syntax 

The syntax of HPcode-Plus instruction COMM is presented beiow: 
COMM <comment) 

so COMM Is used to place comments within the HPcode-Plus Object file 1150, 1160. COMM HPcode-Plus 

instructions can appear anywhere in the HPcode-Plus Object file 1 150, 1 160. 

2.5.9. CSEP - Conditional evaluation SEParator 

35 The syntax of HPcode-Plus instruction CSEP is presented below: 

CSEP 

CSEP leaves the stack unchanged. CSEP is used in conjunction with CEXP HPcode-Plus instructions. 
CSEP HPcode-Plus instructions simply act as delimiters between true clauses and false clauses of 
matching CEXP HPcode-Plus instructions, 
40 An error is generated if CSEP HPcode-Plus instructions are not accompanied by CEXP HPcode-Plus 

instructions. 

2.5.10. CSJP - CaSe JuniP 

46 The syntax of HPcode-Plus instruction CSJP is presented below: 

CSJP <e!se label) 

CSJP pops (selector) from the expression stack. 

CSJP uses (selector) to jump to either a location specified by HPcode-Plus instruction CTAB or (else 
label). 

so CSJP must be immediately followed by one or more consecutive CTAB HPcode-Plus instructions, each 

of which specifies a label and a range of values. No pair of ranges may overlap. 

CSJP branches to the iabef specified by the CTAB HPcode-Plus instruction whose range includes 
(selector), if none of the CTAB ranges include (selector), then CSJP branches to (else label), 
(selector) must be the only item on the expression stack when CSJP is executed. 

55 

2.5.11. CTAB - Case TABIe 



The syntax of HPcode-Pius instruction CTAB is presented below: 
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CTAB <case label) [#]<low bound) [#]<high bound) 

CTAB specifies an entry in a case jump table. CTAB must immediately follow either HPcode-Plus 
instruction CSJP or another CTAB HPcode-Plus instruction. Different CTABs are allowed to have the same 
<case label). 

5 (Low bound) is an integer or a character specifying the lower bound of the range which selects <case 

label)- If [#] is passed, <low bound) must be an integer symbolic identifier of an integer or character 
constant. 

(High bound) is an integer or a character specifying the upper bound of the range which selects (case 
label). (Low bound) has to be less than or equal to (high bound). If [#] if passed, (high bound) must be an 
10 integer symbolic identifier of an integer or character constant. 

2.5.12. CUP - Call User Procedure 



The syntax of HPcode-Plus instruction CUP is presented below: 
75 CUP (proc symid) 

CUP is used to call a procedure or function. (Proc symid), which represents the symbolic id of the 

procedure or function, must be previously defined by the Kl ND FU NC DCL or KiND FUNCTION SYM 

HPcode-Plus instruction. 

CUP initiates the procedure or function call using parameters in the procedure's or function's parameter 
20 area. These parameters were placed in the procedure's or function's parameter area by previous PAR 
HPcode-Plus instructions. 

For function calls (lb,, when the type of the procedure is not TYPE VOID), CUP reserves an area in 

memory for a return value. The return value is actually placed in this memory area by HPcode-Plus 
instruction STFN. 

25 

2.5.13. CVT - ConVerT 

The syntax of HPcode-Plus instruction CVT is presented below: 
CVT (result type) 

30 CVT pops (value) from the expression stack. CVT converts (value) to the data type indicated by (result 
type). The converted (value) is pushed on the expression stack. 
The following conversions are allowed: 

boolean => integer and character 

character ^> boolean, integer, pointer to a data object, or other char types 

35 integer »> boolean, character, floating point, pointer, or other integer types 

floating point => character, integer, or other floating point types 

pointer to a type of data object => character, integer, or pointer to any other type of data object 
pointer to a function of one type -> pointer to a function of another type 

40 2,5.14. DEL - DELete 

The syntax of HPcode-Plus instruction DEL is presented below: 
DEL 

DEL deletes the item on top of the expression stack. 

45 

2.5.15. DiV - Divide 

The syntax of HPcode-Plus instruction DIV is presented below: 
DIV 

so DIV pops (left op) and (right op) from the expression stack. A division (left op)/(right op) is performed to 
produce a result. The result is always a whole number. For example, 5/2 equals 2 (and -5/2 equals -2). 
The result, having the same data type as (left op) and (right op), is pushed on the expression stack. 

2.5.16. PUP » Duplicate 

55 

The syntax of HPcode-Plus instruction DUP is presented below: 
DUP 

DUP pops (value) from the expression stack. DUP then pushes (value) back on the expression stack 
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twice. 

2.5.17. END - END of procedure 

5 The syntax of HPcode-Plus instruction END is presented below: 

END <proc symid) 

END signals the end of a procedure. Thus, END must be the last HPcode-Plus instruction tn the 
procedure. <Proc symid) must match the procedure's symbolic identifier. 

END HPcode-Plus instructions are paired with ENT HPcode-Plus instructions. The expression stack 
10 must be empty when END is executed. END behaves like a RET HPcode-Plus instruction. 

2.5.18. ENT - procedure ENTry 

The syntax of HPcode-Plus instruction ENT is presented below: 
?5 ENT (proc symid) 

ENT identifies a procedure entry point. The procedure must begin with the ENT HPcode-Plus 
instruction to identify the main entry point of the procedure. 

Other ENT HPcode-Plus instructions may be placed in the procedure's body to identify alternate entry 
points (used by some programming languages such as FORTRAN). If alternate entry points are specified, 
20 the flow of control through the procedure must be such that only one ENT HPcode-Plus instruction is 
actually executed. This may be accomplished by preceding each ENT HPcode-Plus instruction which 
specifies an alternate entry point with either the RET HPcode-Plus instruction or a branch instruction. 

There has to be a matching END HPcode-Plus instruction for each main entry ENT HPcode-Plus 
instruction. 

25 

2.5.19. EQU - EQUais 

The syntax of HPcode-Plus instruction EQU is presented below: 
EQU 

30 EQU pops <right op> and <left op> from the expression stack, if <right op) and (left op) are equal, then the 
boolean value TRUE is pushed on the expression stack. Otherwise, the boolean value FALSE is pushed on 
the expression stack. 

2.5.20. FJP - False JumP 

35 

The syntax of HPcode-Plus instruction FJP is presented below: 
FJP (label) 

FJP pops boolean value (condition) from the expression stack. (Condition) must be the only item on the 
expression stack when FJP is executed. 
40 FJP jumps to (label) if (condition) is FALSE. (Label) must occur in a LAB HPcode-Plus instruction in the 

current procedure. 

2.5.21. GEQ - Greater than or EGual 

45 The syntax of HPcode-Plus instruction GEQ is presented below: 

GEQ 

GEQ pops (left op) and (right op) from the expression stack. If (feft op) is greater than or equal to (right 
op), then the boolean value TRUE is pushed on the expression stack. Otherwise, the boolean value FALSE 
is pushed onto the expression stack. For boolean data types, TRUE is greater than FALSE. 

50 

2.5.22. GRT - GReaTer than 

The syntax of HPcode-Plus instruction GRT is presented below: 
GRT 

55 GRT pops (right op> and then (left op> from the expression stack. If (left op) is greater than (right opX 
the boolean value TRUE is pushed on the expression stack. Otherwise, FALSE is pushed on the expression 
stack- 2.5.23. ICUP - Indirect CaJI User Procedure 
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The syntax of HPcode-Plus instruction ICUP is presented below: 
ICUP 

ICUP pops function ptr> from the expression stack. ICUP then calls a procedure which is pointed to by 
(function ptr). The called procedure uses procedure variables which were previously initialized statically or 
5 by LDP HPcode-Plus instructions, ICUP is commonly used to support procedures as parameters in Pascal 

If ICUP is calling a function (i.e., if the procedure's data type is not TYPE VOID), then a return value 

will be pushed onto the expression stack after the call. 

w 2,5.24. ICVT - Integral ConVerT 

The syntax of HPcode-Plus instruction ICVT is presented below: 
ICVT 

ICVT pops <value> from the expression stack. ICVT performs an integral promotion of <value> as defined 
75 by ANSI-C to produce a result. ICVT then pushes the result onto the expression stack. 

ICVT accepts only unsigned integral types. For signed varieties, CVT should be used. 

Since the ANDF Producer 208 cannot determine the result's data type, the result cannot be used 
immediately for an arithmetic operation which requires operands to be of the same type. The ACVT 
HPcode-Plus instruction should be used if an arithmetic operation is to be performed. 

20 

2.5.25. ILOD - Indirect LOaD 

The syntax of HPcode-Plus instruction ILOD is presented below: 
ILOD 

25 ILOD pops (address) from the expression stack. (Address) represents an address of a data object. The 
data object referenced by <address) is retrieved and then pushed onto the expression stack. 

If (address) references a structure or array, then the structure or array is pushed onto the expression 
stack with the ILOD HPcode-Pfus instruction. 

30 2.5.26. INC - INCrement 

The syntax of HPcode-Plus instruction INC is presented below: 
INC (offset) 

INC pops <value> from the expression stack, and increments <value) by (offset) to produce a result. If 
35 (value) is an address, (offset) is scaled to the size of the data object pointed to by (value). The result is 
pushed onto the expression stack. 

2.5.27. !NIT - INITialize static data area 

40 The syntax of HPcode-Plus instruction IN IT ts presented below: 
I NIT (target ^d) (source id) 

I NIT is used to initialize static, global, and constant data areas. A source, represented by (source id), is 
compatible with a target, represented by (target id), if 
o (source id) and (target id) are of the same data type, 
45 o (source id) and (target id) are both simple types and (source id) can be converted to (target id) using 
a CVT HPcode-Plus instruction. In such cases, the ANDF Installers 21 8, 228 perform implicit CVT 
instructions, or 

o (source id) and (target id) are array types and the types of the array elements are the same but the 
dimension size of the source is smaller than that of the target. In such cases, the ANDF Installers 218, 
so 228 perform partial initialization, 

2.5.28. INST - Indirect Non-destructive STore 



The syntax of HPcode-Plus instruction INST is presented below: 
55 INST 

INST pops (item) and then (address) from the expression stack. INST then stores (item) into (address). 
INST also pushes (item) back onto the expression stack. 
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2.5.29. IOR - Inclusive OR 

The syntax of HPcode-Plus instruction IOR is presented below: 
IOR 

5 IOR pops <op1> and <op2> from the expression stack. A logical OR operation, <op1> OR <op2), is 

performed to produce a result. The result, having the same data type as (opD and (op2) r is then pushed on 
the expression stack. 

For integer and character data types, a bitwise OR is performed- That is, corresponding bits in (op1> 
and (op2) are ORed. 

w 

2.5.30. ISTR - Indirect SToRe 

The syntax of HPcode-Plus instruction fSTR is presented below: 
ISTR 

rs ISTR pops <item> and then (address) from the expression stack. ISTR then stores (item) into (address). 

2.5.31. IXE - IndeX an Element 

The syntax of HPcode-Plus instruction IXE is presented below: 
20 IXE (data type) 

IXE pops (index item) and (base address) from the expression stack. The value of (index item) is 
multiplied by the size of the data type specified by (data type). The product of this multiplication is added to 
(base address) to produce a result. The result, representing an index address, is then pushed onto the 
expression stack, 

25 

2.5.32. IXF - IndeX a Field 

The syntax of HPcode-Plus instruction IXF is presented below: 
IXF (fieldtype) 

IXF pops (base address) from the expression stack. (Base address) represents the address of a 
structure, (Fieldtype) represents the symbolic id of a field within the structure. 

IXF determines the offset from the beginning of the structure (specified by (base address) ) to the field 
(specified by (fieldtype) ). IXF adds the offset to (base address) and then pushes the sum of this addition to 
the expression stack, 

(fieldtype) can be a field of a structure type in the case of nested structures. 

2.5.33. LAB - LABel 

The syntax of HPcode-Plus instruction LAB is presented below: 
40 LAB (label) (flag) 

LAB defines the location of (label) in a sequence of HPcode-Plus instructions. Executing LAB has no 
effect on the expression stack, although the expression stack must be empty when it is executed. 

(Label) consists of one or more digits or alphabetic characters or '$\ Ail labels must be unique within a 
compilation unit. Externa! labels must start with a letter. The values of (flag) and their associated conditions 
as are: 



Value Condition 

0 A local label that cannot be referenced by a 
G00B HPcode-Plus instruction, 

1 An external label that can be referenced by a 
G008 HPcode-Plus instruction, 

55 

Note that GOOB is not used by ANSI-C. GOOB is used for Pascal to branch to a non-local label. 
2.5.34. LDA - LoaD Address 
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The syntax of HPcode-Plus instruction LDA is presented below: 
LDA <symid> 

LDA pushes the address specified by <symid> to the expression stack. (Symid) is the symbolic id of a 

variable (defined by a KIND SVAR, KIN D FPAR AM , or KIND DVAR SYM HPcode-Plus instruction) or a 

5 constant (defined by a KIND CONST SYM HPcode-Plus instruction or another constant defining SYM 

HPcode-Plus instruction). 

2.5.35. LDC - LoaD Constant 

w The syntax of HPcode-Plus Instruction LDC is presented below: 
LDC (type symid) <value) 

LDC pushes a simple constant to the expression stack (HPcode-Plus instruction LOD is used to push an 
aggregate constant to the expression stack). 

<Type symid) and (value) specify the data type and the value, respectively, of the constant. (Value) 
75 must be within the range associated with (type symid). 

The external format of (value) is dependent upon the value of (type symid): 

TYPE BOOLEAN Either an integer 0 or an integer 1 , representing FALSE or TRUE, respec- 

tively. 

TYPE CHAR An ASCII character in double quotes, with a double quote being represented 

20 by An integer is also allowed. The integer will be converted implicitly 

to a character by the ANDF Installer 218, 228. 

TYPE UNS CHAR An ASCII character in double quotes, with a double quote being represented 

by An unsigned integer is also allowed- The integer will be converted 

implicitly to a character by the ANDF Installer 218, 228. 

25 TYPE SINT An integer. An ASCII characer in double quotes is also allowed. The ASCII 

character will be converted implicitly to an integer by the ANDF Installer 
218, 228. 

TYPE INT An integer. An ASCII characer in double quotes is also allowed. The ASCII 

character will be converted implicitly to an integer by the ANDF Installer 
30 21 8,228. 

TYPE LONGJNT An integer. An ASCII characer in double quotes is also allowed. The ASCII 

character will be converted implicitly to an integer by the ANDF Installer 
218, 228, 

TYPE_JJNS SINT A positive integer. An ASCII characer in double quotes is also allowed. The 

35 ASCII character will be converted implicitly to a positive integer by the 

ANDF Installer 218. 228. 

TYPE UNS INT A positive integer. An ASCII characer in double quotes is also allowed. The 

ASCII character will be converted implicitly to a positive integer by the 
ANDF Installer 21 8, 228. 

40 TYPE UNS LONGINT A positive integer. An ASCII characer m double quotes is also allowed. The 

ASCII character will be converted implicitly to a positive integer by the 
ANDF Installer 218, 228. 



45 



50 



2.5.36. LDP - LoaD Procedure entry 

The syntax of HPcode-Plus instruction LDP is presented below: 
LDP <proc) 

LDP pushes (proc), the symbolic id of a procedure, onto the expression stack. LDP is typically used to 
pass procedures as parameters, or to assign procedures to procedure variables. 

2.5.37. LEO - Less than or EQuai 



The syntax of HPcode-Plus instruction LEQ is presented below: 
LEQ 

65 LEO pops (right op> and (left op) from the expression stack. If (left op> is less than (right op), then the 

boolean value TRUE is pushed onto the expression stack. Otherwise, the boolean value FALSE is pushed 
onto the expression stack. 
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2.5.38. LBS : LESs Than 

The syntax of HPcode-Plus instruction LES is presented below: 
LES 

5 LES pops <r»ght op) and (left op> from the expression stack. If <left op) is less than (right op> 5 the 

boolean value TRUE is pushed onto the expression stack. Otherwise, the boolean value FALSE is pushed 
onto the expression stack. 

2.5.39. LOC - LOCatton 

10 

The syntax of HPcode-Plus instruction LOC is presented below: 
LOC 

LOC is used for debugging purposes. The ANDF Producer 208 generates LOC HPcode-Plus instruc- 
tions when SYMBOLIC DEBUG OPTN HPcode-Plus instructions are encountered. 
15 LOC is used to correlate a source language statement number (i.e., the offset) with a current location 

counter. LOC must precede HPcode-Plus instructions associated with source language statements. 

2.5.40. LOD - LOaD 

20 The syntax of HPcode-Plus instruction LOD is presented below: 

LOD <item> 

LOD pushes <item) onto the expression stack. (Item) can be a simple variable, a constant, or an 
aggregate variable such as an array or a structure- 

25 2.5.41. MCAL - Macro CALI 



The syntax of HPcode-Plus instruction MCAL is presented beiow: 
MCAL (macro) (parm list) 

MCAL Invokes (macro). (Macro) represents the symbolic id of a valid macro definition. (Macro> must be 

30 previously defined in a KIND MACRO SYM instruction. 

(Parm list) represents the actual parameters to (macro). The number of parameters in <parm list) must 
match the definition for (macro). 

2.5.42. MPY - MultiPlY 

The syntax of HPcode-Plus instruction MPY is presented below: 
MPY 

MPY pops (op1) and (op2) from the expression stack. A multiplication (op1)*(op2) is performed to 
produce a result. The result, having the same data type as (opt) and <op2) f is then pushed onto the 
40 expression stack. 

2.5.43. MST - Mark STack 



The syntax of HPcode-Plus instruction MST is presented below: 
45 MST 

MST is used to mark the expression stack in preparation for a procedure call. After marking the 
expression stack with MST, actual parameters for the procedure can be pushed onto the expression stack 
with PAR HPcode-Plus instructions. 

The expression stack need not be empty before executing MST. 

50 

2.5.44. NEG - NEGate 

The syntax of HPcode-Plus instruction NEG is presented below: 
NEG 

55 NEG pops (value) from the expression stack. NEG then negates (value) to produce a result. The result 

is pushed onto the expression stack. 

(Value) must be a signed integer or a floating point. The result has the same type as (value). 
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2.5.45. NEQ - Not EQUals 

The syntax of HPcode-Pius instruction NEQ is presented below: 
NEQ 

5 NEQ pops (right op) and {left op> from the expression stack. If (right op> and (left op) are not equal, the 

boolean value TRUE is pushed onto the expression stack. Otherwise, the boolean value FALSE is pushed 
onto the expression stack. 

{Right op> and <left op) must be the same data type. 

w 2.5.46. NOP - No Op 

The syntax of HPcode-Pius instruction NOP is presented below: 
NOP (argument list) 
NOP represents a non-operation. 
75 The ANDF installers 218, 228 ignore NOP instructions. Parameters in (argument list) are passed to the 
next HPcode-Pius instruction. 

2.5.47. NOT - NOT 



20 The syntax of HPcode-Pius instruction NOT is presented below: 
NOT 

NOT pops (value) from the expression stack. NOT then performs a logical NOT operation on (value) to 
produce a result. The result is then pushed back onto the expression stack. 

For integer and character types, each bit of (value) is NOT'ed. For boolean types, the values TRUE and 
25 FALSE are NOT f ed. 

2.5.48. OPTN - Option 

The syntax of HPcode-Pius instruction OPTN is presented below: 
30 OPTN (option number) (parameter list) 

OPTN is used to transmit option information from the ANDF Producer 208 to the ANDF Installers 218, 
228. In general* the option information causes the ANDF Installers 218, 228 to alter the manner in which 
they generate code. 

(Option number) represents an option. (Parameter list) represents a sequence of zero or more 
35 parameters. The number and interpretation of (parameter list) depend on the value of (option number). 

OPTN HPcode-Pius instructions may be located in only specific parts of the HPcode-Plus Object file 
1150, 1160. For example, some OPTN HPcode-Pius instructions, depending on the value of (option 
number), may be located anywhere within a procedure. Others must be located outside the procedure (i.e., 

before a KIND FUNCTION SYM instruction). 

40 In general, OPTN, once set, remains in effect until it is reset. 

Possible values for (option number) are listed below; 
LANGUAGE TYPE 
WARNING LEVEL 
CODE LISTING 
45 LOCALITY SET 
1NIT 

SYMBOLIC DEBUG 

COPYRIGHT 

PROGRAM ENTRY PT 
so HPcode Plus VERSION 

COMPILATION REC 

OPTIMIZATION 

ASSEMBLER FILE 

OBJECT FILE 
55 USER VERSION 

ROUNDING MODE 

CONVERSION OVERFLOW CHK 

ARITHMETIC OVERFLOW CHK 
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PROCEDURE SIDE EFFECT 
LIBRARY FILE 
PROGRAM FILE 

5 2.5,49. PAR - PARameter 



The syntax of HPcode-Plus instruction PAR is presented below: 
PAR 

PAR pops (value) from the expression stack, PAR stores <value> into the parameter area of a procedure 
to to be called. 

2.5.50. REM - REMainder 

The syntax of HPcode-Plus instruction REM is presented below: 
75 REM 

REM pops (left op) and <right op) from the expression stack. A division (left op)/<right op> is performed 
to produce a result. The result represents the remainder of the division operation. For example, 4/2 equals 
0, 5/2 equals 1, and -5/2 equals -1. 

The result is then pushed onto the expression stack. 

20 

2.5.51. RET - Return 



The syntax of HPcode-Plus instruction RET is presented below: 
RET 

25 RET returns program control from a called procedure to a calling procedure. Before returning 
programming control, RET restores the static and dynamic computing environment of the calling procedure. 
\f the current procedure is a program entry point, norma! program termination wMl occur. 
The expression stack must be empty before RET is executed. 

30 2.5.52. RND - Round 

The syntax of HPcode-Plus instruction RND is presented below: 
RND <result dtype) 

RND pops (real values) from the expression stack. If (real value) is positive, then RND adds 0.5 to (real 
35 value) to produce a temporary result. If (real value) is negative, then RND adds -0.5 to (real value) to 
produce the temporary result 

The integer part of the temporary result is converted to the data type indicated by (result dtype) and 
then pushed onto the expression stack, 

40 2.5.53. ROT - ROTate 



The syntax of HPcode-Plus instruction ROT is presented below: 
ROT 

ROT rotates the top three items on the expression stack. For example, suppose the expression stack 
45 contains <op1> <op2)(op3) before ROT, where <op1> is the top of the expression stack. After ROT, the 
expression stack would contain (op3> <op1) (op2), where (op3) is the top of the expression stack. 

2.5.54. SHFT - SHIFT 

so The syntax of HPcode-Plus instruction SHFT is presented below: 
SHFT (direction) 

SHFT pops (item) and (shift count) from the expression stack, SHFT then shifts (item) by (shift count) 
bit positions to produce a result. The result is pushed onto the expression stack. 

When (direction) is 0 t (item) shifts either right or left, depending on the sign of (shift count). If the ANDF 
55 Producer 208 knows the shift direction, then (direction) should be set to t for a left shift and to -1 for a right 
shift. (Shift count) must be positive when (direction) is 1 or -1. 

The meaning of SHFT depends on the data type of (item). For signed integers, an arithmetic shift is 
performed. For unsigned integers, a logical shift is performed. 
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Since the result depends on the size of (item), SHFT must be used with caution, ANDF Installers 218, 
228 may generate a warning when SHFT is used. 

2.5.55. STFN - STore FuNction result 

5 

The syntax of HPcode-Plus instruction STFN is presented below: 
STFN 

STFN is used to return a function result Specifically, STFN pops <value> from the expression stack. 
STFN then stores (value) in the memory return area set aside by HPcode-Ptus instruction CUP- The data 

10 type of <vaiue> must match the function's return value data type defined in the KIND FUNCTION SYM 

instruction. 

2.5.56. STR - SToRe 



75 The syntax of HPcode-Pius instruction STR is presented below: 
STR (variable symid) 

STR pops (value) from the expression stack and stores (value) into the variable specified by (variable 
symid). The data type of <value> must match that of (variable symid). 

If (variable symid) represents the symbolic id of a constant (i.e., the constant attribute is set), then the 
20 behavior of STR is implementation dependent. In such cases, the ANDF Installers 218, 228 generate a 
warning message. 

2.5.57. SUB - SUBtract 

25 The syntax of HPcode-Plus instruction SUB is presented below: 
SUB 

SUB pops (left op) and (right op) from the expression stack. A subtraction (left op)-(right op) is 
performed to produce a result. The result, having the same data type as (left op) and (right op), is then 
pushed onto the expression stack. 
30 When (left op) and (right op) represent two data addresses, then the result will be a scaled integer of 

TYPE INT (the result is scaled as with INC/IXE, but in a reverse manner). Data objects pointed to by (left 

op) and (right op) must have the same data type. The behavior of such pointer subtraction is implementa- 
tion dependent 

35 2.5.58. SWP - SWaP 

The syntax of HPcode-Plus instruction SWP is presented below: 
SWP 

SWP pops the top two stack items and pushes them back onto the expression stack such that their 
40 stack positions are reversed. 

2,5,59. SYM - SYMoof Table 

The syntax of SYM is presented below: 
45 SYM (symid) (sym kind) (sym info) 

SYM is used to defer memory allocation from the ANDF Producer 208 to the ANDF Installers 218, 228. 
Specifically , through SYM, variable, type, and constant information is conveyed from the ANDF Producer 
208 to the ANDF Installers 218, 228. The ANDF Installers 218, 228 use this information to perform memory 
allocation, alignment, initialization, and machine dependent constant folding. 
so The ANDF Producer 208 use SYM to give a unique symbolic identification (also called symid or 
symbolic id) to each data object and data type. The only exception to this rule is that the symid of data 
types and data objects in local scopes can be reused. 

The ANDF Producer 208 also uses the SYM instruction to associate a memory type (e.g., Static, Local, 
or Parameter) and attribute (e.g., Constant. Register, or Volatile) with each data object. 
55 SYM parameters (or fields) syrnid, sym kind, and sym info are described in the following sections. 

2.5.59.1. Symid 
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Symid stands for Symbolic identifier. Symids are used by HPcode-Pius instructions to refer to variables, 
data types, and constants. For example, rather than using an actual physical address to access a data 
object in memory, HPcode-Plus instructions use the data objecfs symid. 

The ANDF Producer 208 assigns symid values starting at 256, although assignment need not be 
5 sequential. The ANDF Producer 208, however, does not assign symid values greater than 65535 unless all 
smaller values have been used. 

The ANDF Installers 218, 228 must accept symids with values up to at least 65535. 

HPcode-Plus includes predefined symids for predefined data types listed in Figure 5. These data types 
are the only ones that need not be explicitly defined by SYM HPcode-Plus instructions. The predefined 
w symids are presented in Figure 9. 

The size of the predefined data types depends on the target computer platform 216, 226 and is 

determined by the ANDF Installer 21 8 4 228. Thus, TYPE INT can be 16 bits on one computer platform and 

32 bits on another. AM that the ANDF Producer 208 can rely on is certain minimum ranges, and that 

TYPE SHORTINT is no larger than TYPE INT and TYPE INT is no larger than TYPE LONGINT. 

75 A function begins with a KIND FUNCTION declaration and terminates with a matching KIND END. 

Properly nested functions, as in Pascal, might exist. The nesting structure is determined implicitly by the 
placement of KIND FUNCTION and KIND END SYM HPcode-Plus instruction pairs. 

Certain symids, such as the KIND DVAR declarations of dynamic variables and the KIND FPARAM 

declarations of formal parameters are also implicitly associated with the nearest enclosing function. 

20 When the function is terminated by the matching KIND END, all local symid declarations of associated 

interior objects become unavailable. The ANDF Producer 208 may reuse any of these tT freed" symid values 
in new SYM declarations. The ANDF Producer 208 reuses such synmd values to minimize the size of tables 
at the ANDF Installers 218, 228. 

In addition, the ANDF Producer 208 can explicitly tell the ANDF Installer 218, 228 that other symid 
25 values (such as a type declaration) are "freed" upon function termination. This is done by using a <free> 
parameter in those symid declarations, ff the <free> parameter is 0, then the symid value will not be freed. If 
the <free) parameter is 1> then the symid value is associated with the nearest enclosing function and when 
the function is terminated, the symid vahje is freed. 

$0 2.5.59.2. $ym Kind and Sym Info 

<Sym kind) and <sym info) are fields which contain symbolic kind and symbolic information, respec- 
tively. The structure of <sym info) depends on the value of <sym kind). Possible values of <sym kind) are 
presented in Figure 10. 

35 Listed below are descriptions showing the relationship of <sym kind) and <sym info). These descriptions 

contain definition and usage information, 

2.5.59.2.1. KIND POINTER 

40 

Syntax: SYM <symid> KIND POINTER <froe) <type> [<name>] 

This SYM variation defines a data object pointer type. 

(free) is a flag which indicates whether <symid) is freed when the nearest enclosing function is 
4B terminated. 

<type) is a symbolic id for the data type that the pointer is to point to. <Type) must represent a data type 
and may either be a HPcode-Plus predefined data type {listed in Figure 5), an existing symbolic id type, or 
a forward reference to a symbolic id type. In the last case 1 it is permissible to never supply the missing 
reference, as long as information about the missing type is not needed. To define a pointer type to a 
so function, see the KIND FUNC_PTR SYM entry, below. 

(name) is a name which is used to reference the pointer type during symbolic debug operations. 



2.5.59.2.2. KIND STRUCTURE 

55 

Syntax; SYM (symid) KIND STRUCT (freeXfirst field><packing>[(name>] 

This SYM variation defines a structure data type. 

25 
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<free) is a flag which indicates whether <symid> is freed when the nearest enclosing function is 
terminated. 

(first field) is a symbolic id of the first field in a structure. This may be a forward reference to a 
symbolic id. <First field) may also be a special vaiue G\ indicating an incomplete structure definition which 
5 may be completed later. Symbolic ids of field definitions are chained together in a list by use of the 

KIND FIELD symbolic declaration. Ail fields of the structure must be declared before the size of the 

structure is needed. 

(packing) is a flag which indicates whether the structure has normal, packed, or crunched packing. 
Normal packing implies that the ANDF Installer 218, 228 packs fields and array elements in a manner 
io which is consistent with the packing method of the target computer platform 216, 226. 

Packed implies that the ANDF Installer 218, 228 packs fields and array elements in a manner which is 
consistent with the packed packing method of the target computer platform 216, 225- Languages like Pascal 
allows users to specify PACKED packing for arrays and structures. 

Crunched packing implies that the ANDF Installer 218, 228 may not expand fields and may not leave 
is holes. Every field is bit aligned to conserve space. 

(name) is a name which is used to reference the structure type during symbolic debug operations. 

2.5,59.2.3. KIND UNION 

20 

Syntax: SYM (symid) KIND_UNION (freeXftrst fie!d)[<name>] 
This SYM variation defines a union data type. 

(free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
25 terminated. 

(first field) is a symbolic id of the first field in the union. This may be a forward reference to a symbolic 
id. (First field) may also be the special value 0, indicating an incomplete union definition which may be 
completed later. Symbolic ids of the field definitions are chained together in a list by use of the 

KIND FIELD symbolic declaration. All fields of the union must be declared before using the size of the 

30 union. 

(name) is a name which is used to reference the union type during symbolic debug operations. 
Pascal variant records can be implemented in HPcode-Plus as a structure whose last field is a union of 
structures, 

35 2.5.59.2.4. KIND ARRAY 

Syntax: S Y M < s y m i d ) K I N D ARRAY (free)(size)(type)<packing)[(name)] 

This SYM variation defines a structure of an array. 
40 (free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
terminated. 

(size) indicates the number of elements in the array. (Size) may be a simple integer constant, or a 
symid (using the #n notation) of an already defined symbolic constant or variable (in languages which 
support dynamic sizes, such as FORTRAN and Ada). (Size) is set to the constant 0 to specify an array with 
46 unknown size. The array's definition is later completed with an additional SYM HPcode-Plus instruction. 
A multi -dimensional array is defined to be an array of arrays. 

(type) is a symbolic id which indicates the data type of each element of the array. 

(packing) is a flag indicating the type of packing desired as in the description for KIND STRUCT, 

above. 



2.5.59.2.5. KINP.ENUM 

55 

Syntax: SYM (symid) KIND ENUM (freeXmemberXbase type)f(name)] 

This SYM variation defines an enumerated type. 

(free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
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terminated. 

{member) is a symbolic id of the first member declaration, (member) may be a forward reference to a 
symbolic id, (member) may also be a special value 0, indicating an incomplete enumerated type definition 
which may be completed later. Symbolic ids of the member definitions are chained together in a list by use 

5 of the KIND MEMBER symbolic declaration. All members of the enumerated type must appear before 

using the size of the enumerated type. 

(base type) is a symid of a predefined integral type. When a member of the enumerated type is located 
on the HPcode-Plus expression stack, an implicit type conversion to the (base type) is performed. Similarly, 
items of the <base type) on the stack may be stored into variables of the enumeration type without an 
w explicit conversion. 

(name) is a name which is used to reference the enumerated type during symbolic debug operations. 

Mote that the width of the enumerated type is not required to be the same as the width of the (base 
type). The actual size of a variable of enumerated type is decided by the ANDF Installer 218, 228. The 
actual si2e should be a multiple of the size of TYPE CHAR. \n a crunched structure or array, the size of an 
15 enumerated type field or element should be as small as possible. 

2.5.59.2.6. KIND FUNCT PTR 



Syntax: SYM (symid) KIND FUNC PTR (freeXreturn type) [(name)] 

20 The SYM variation defines a "pointer to a procedure" data type. 

(free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
terminated. 

(return type) is a symbolic id of the data type returned by the procedure. 

(name) is a name which is used to reference the function pointer type during symbolic debug 
25 operations. 



2.5.59.2,7. KIND MODIFIER 

30 

Syntax: SYM(syrnrd)KIND MODIFIER <free><modificationXtype>(<nam©>] 

This SYM variation defines a modified type of an existing type declaration. The original data type and 
the modified data type are compatible. 

(free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
35 terminated. 

(modification) is a flag with possible values 0, 1, or 2. 

A (modification) value of 0 indicates that the new data type is a synonym of the original data type (with 
possibly a different name for symbolic debug purposes). 

A (modification) value of 1 indicates the addition of a constant attribute to the original data type. 
40 Variables wfth the constant attribute may not be modified and may be placed into read only memory. No 
checking need be done by the ANDF Installer 218, 22S to ensure that constant variables are not actually 
modified. 

A (modification) value of 2 indicates the addition of a volatile attribute to the original data type. Variables 
with the volatile attribute have limitations placed on the amount of cacheting the ANDF Installer 218, 228 
45 can do on their values. 

(name) is a name which is used to reference the modified data type during symbolic debug operations. 



2.5.59.2.8. KINDFIELD 

50 ~ ' "* 

Syntax: SYM (symid) KIND FIELD (type)(field)[(name>][(bit length)] 

This symbolic variation declares a field within a structure or union. This declaration is neither a type nor 
a variable declaration. Outside of their definition in SYM instructions, field symbolic ids are used in IXF 
55 HPcode-Plus instructions and in SYM initialization of unions- 
(type) is a symbolic id of the type of the field. 

(field) is a symbolic id of the next field in the structure or union, if there is one. Otherwise, this 
parameter is 0. This may be forward reference, 
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(name) is a name which is used to reference the field during symbolic debug operations. 

(bit length) is either an integer constant or a symbolic id of a integral constant {in #n notation). This 
indicates the length of the field in bits. A (bit length) of 0 indicates an alignment directive in the structure 
(even in crunched structures). A (bit length) of -1 or one that is missing altogether indicates that the field 
5 should have the same number of bits as free variables of the field (type). 

The symid associated with KIND FIELD is freed at the termination of the nearest enclosing function, if 

and only if the symid of the structure or union is freed. 

io 2.5,59.2,9. KIND FUNCTION 



Syntax: SYM <symid) KIND FUNCTION (typeXffagXfparam) [(visible name)][<name)] 

This SYM variation marks the start of a function definition. There must be a matching KIND END SYM 

;5 HPcode-Plus instruction to terminate the function. Function definitions may be properly nested. 
<type) is a symbolic id of the type returned by the function, 

<flag) is a flag which indicates whether the function accepts a fixed number or a variable number of 
arguments. 

<fparam> is a symbolic id of the first formal parameter (defined by a KIND FPARAM SYM HPcode-Plus 

20 instruction) in a list of formal parameters for the procedure/function. This parameter should be 0 if there are 
no parameters- This may be a forward reference to a symbolic id. 

(visible name) is a name of the procedure that external compilation units use to reference the 
procedure. It is used by a linker (not shown in Figure 2) for resolution. If no external references are allowed, 
then this parameter can be missing or the empty name, "", can be provided, 
25 (name) is an internal name for the procedure, (name) and (visible name) may be different, (name) may 
be passed to a linker (not shown in Figure 2) for informative purposes, (name), however, is local. Thus, 
(name) may not be used to resolve external references. 

The symids associated with KIND FUNCTION SYM HPcode-Plus instructions are freed when the 

nearest enclosing functions are terminated. 

30 

2.5.59.2.10. KIND FUNC DCL 

Syntax: SYM<symid}K!ND FUNC DCL (free>(type>[(visib!e)][(name)] 

This SYM variation declares a procedure or function which may be external to the compilation unit. 
35 (free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 

terminated- 

(type) is a symbolic id of the type returned by the function. 

(visible name) is a name that is used to reference the procedure, it is used by the linker (not shown in 
Figure 2) for resolution. 
40 (name) is an internal name which is used during symbolic debug operations. 



2.5.59.2.11. KINDJPARAM 

45 

Syntax: SYM (symid) KIND FPARAM (typeXnext fparam)(memory)[(name)] 

This SYM variation declares a formal parameter of a procedure or function, 
(type) indicates the type of the formal parameter. 

(next fparam) is a symbolic id of the next formal parameter in the list, if this parameter is 0, then there 
so are no more formal parameters. This may be a forward reference. 

(memory) is a flag with possible values 0 or 1. This indicates a hint to the ANDF Installer 218, 228 on 
whether it should try to allocate the parameter in normal (0) or "fast" (1) memory. 

(name) is a name which is used to reference the formal parameter during symbolic debug operations. 

The symid associated with a KiND FPARAM SYM HPcode-Plus instruction is freed when the nearest 

55 enclosing function is terminated. 

2.5.59.2.12. KIND SVAR 
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Syntax: SYM(sym i d ) K I N D SVAR (freeXtype)(imported)[(visible name)][<name>] 

This SYM variation declares a static variable (with respect to storage). 

<free> is a flag which indicates whether <symid> is freed when the nearest enclosing function is 
terminated. 

5 <type> is a symbolic id of the type of the variable. 

(imported) is a flag with the possibte values 0 or 1. (imported) indicates whether the variable is defined 
in this compilation unit (0) or is an external reference (1). 

(visible name) is a name which is used by the linker (not shown in Figure 2) to resolve references, 
(visible name) must be present if this is an external declaration. If no external references are allowed for a 
10 defined variable (e.g. a static definition), then this parameter can be missing or the empty name, M,, 5 can be 
provided. 

(name) is an interna! name of the variable in case (visible name) is not the same, (name) may be 
passed to the linker for informative purposes, (name), however, is a local name, Thus, (name) may not be 
used to resolve references. 



2,5,59.2,13. KIND DVAR 

20 Syntax: SYM (symid) KIND DVAR (type)(memory)[(name)] 

This SYM variation declares a dynamic variable (Le, locals or temporaries), 
(type) indicates the symbolic id of the type of the variable. 

(memory) is a flag with possible values 0 or 1. This indicates a hint to the ANDF Installer 218, 228 on 
whether it should try to allocate the parameter in normal (0) or "fast" (1) memory. 
25 (name) is a name which is used to reference the variable during symbolic debug operations. 

The symid associated with a KIND DVAR is freed when the nearest enclosing function is terminated. 

2.5,59.2.14. KIND MEMBER 



30 Syntax: SYM (symid) KIND MEMBER <member)[(name)]t(value)] 

This SYM variation defines a member of a enumerated type, (symid) may be used by the ANDF 
Producer 208 in a LOD HPcode-Plus instruction. 

(member) is a symbolic id of the next member of the enumerated type defined by a KIND MEMBER 
entry. This may be a forward reference. \f this parameter is 0, then this is the last member of the 
35 enumerated type. 

(name) is a name which is used to reference the member during symbolic debug operations. 

(value) is either an integer constant or the symbolic id of a integral constant (in #n notation), if this 
(value) is missing, then the value is equal to the previous member's value plus 1 , or 0 if this is the first 
member. 

40 Symids associated with KIND MEMBER HPcode-Plus instructions are freed upon the termination of 

the nearest enclosing function, if and only If the symid of the enumerated type is also freed. 

2.5.59,2,15. KIND OFFSETQF 



Syntax: SYM(symtd)KIND OFFSETOF <free)<struct>(field)[(resu!t type)] 

This SYM variation defines a symbolic id for the constant offset in bytes of a field from the beginning of 
the enclosing structure. 

so (free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 

terminated. 

(struct) is a symbolic id of the structure type, 

(field) is a symbolic id of the field whose offset is to be returned. 

(result type) is a symbolic id of the type of this symid constant. If (result type) is not specified, then the 
55 result is of TYPE UNS INT. 
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2.5.59.2.16. KIND SIZEOF 



5 Syntax: SYM (symid) KIND SIZEOF (free) <data type) [(result type)] 

This SYM variation defines a symbolic id for the constant size of a data type expressed as a number of 
TYPE CHAR sized units. 

(free) is a flag which indicates whether <symid> is freed when the nearest enclosing function is 
terminated. 

w (data type) is a symbolic id of the type whose size is determined. 

(result type) is a symbolic id of the type of (symid) constant If this is not specified, the result is of 
TYPE_UNS_JNT. 

2,5-59-2.17, KIND MAXOF 

15 

Syntax: SYM (symid) KIND MAXOF (free) (data type) 

This SYM variation defines a symbolic id for the constant maximum representable value for the 
specified type. 

(free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
20 terminated, 

(data type) is a symbolic id of the type whose maximum value is determined. The result type is always 
(data type). 

25 2.5.59.2.18. KIND HINOF 



Syntax: SYM (symid) KIND MINOF (free) (data type) 

This SYM variation defines a symbolic id for the constant minimum representable value for the specified 
30 type. 

(free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
terminated. 

(data type) is a symbolic id of the type whose minimum value is determined. The result type is always 
(data type). 

35 

2.5.59.2.19. KIND__C0NST 

Syntax: SYM (symid) KIND_CONST (free) (type) (constant value list) [("name)"] 
40 This SYM variation defines a constant. The constant may be a simple value, a structure constant, or a 
list of values in an array. 

(free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
terminated. 

(type) designates a symbolic id of the type of the constant, 
45 (constant value list) are values that are used to initialize the constant. 

(name) is a name which is used to reference the constant during symbolic debug operations. 
A specification of single scalar items or scalar items contained within an aggregate list is described in 
the following table: 
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Scalar Items 
Description 



Exampl e 



10 



15 



20 



integer 123 

Integral or single quoted character M a M 

Character constant symbolic id ;300 

False 0 

Data Pointer True 1 

constant symbolic id ;301 

Floating real number in ANSI-C syntax 5.3el0 

constant symbolic id ;302 

NIL 0 

Data Pointer NEW_CONST symbolic id ;304 

NIL 0 

FUNCJTR NEWJIONST symbolic id ;307 



25 



30 



35 



To specify an array or structure aggregate, items are listed in order, enclosed by brackets [ ]. For 
arrays, items are placed in subsequent array elements. For structures, each item in the list is placed into 
the corresponding field position. To facilitate readability of the HPcode-Plus Object file, the newline 
character is treated as ordinary white space between enclosing brackets. That is, an aggregate's initializa- 
tion list may span multiple lines. 

Not all items in the aggregate need to be initialized. 

To initialize nested aggregates, the nested aggregate can be specified by a sub-list delimited by 
brackets. The nested aggregate can also be represented by a single symbolic id of an already defined 
constant of the nested aggregate type. Multi-dimensional arrays are initialized in row-major order. 

An empty pair of quotes/"", denotes a non-initialized item in the list. 

Adjacent items in a list initialized by quoted characters may be joined together within a single pair of 
quotes. For example, "a" "b M rt c" may be written as "abc". 

Duplicated items in a list may be specified by repeafitem, where repeat is an integer or a symbolic id 
of an integer in #n notation. Adjacent non-initialized items may be specified by repeat*"". 

To initialize a union, the first item in the list is a field symid (in #n notation) denoting which field of the 
union is being initialized. 



40 



2.5.59.2.20. KIND NEW CONST 

45 

Syntax: SYM <symid> KlND_NEW_CONST <free> 

This SYM variation defines a new constant. The new constant is defined by HPcode-Plus instructions 
which follow the KtND_NEW_CONST SYM HPcode-Plus instruction. 

The KIND_NEW_CONST SYM HPcode-Plus instruction allows the ANDF Producer 208 to transfer 
50 constant folding activities to the ANDF Installer 218, 228 while being able to use a symbolic id to represent 
the constant folding result. Any HPcode-Plus instructions can be used to generate the constant, except for 
procedure calls, branches, loads from variables, and stores to variables. The operands and parameters of all 
HPcode-Plus instructions in the sequence must represent known constants available to the ANDF Installer 
218, 228. 

55 At the end of the HPcode-Plus instruction sequence, there must be a single item on the expression 
stack with a constant value. The value and type of this item are associated with the symbolic id of the 
KIND_NEW__CONST, 

KlND ^ NEW ^ C0NST constructors may be nested. 
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The ANDF Installers 218, 228 are not required to pre-evaluate the instructions in K!ND_NEW_CONST 
sequences, but the HPcode-Plus program must behave as if they did. For example, if the symbolic id of a 

KIND_NEW_CONST is used as the (size) specifier in a KIND ARRAY declaration, the effect must be as 

if an ordinary integer value were specified. 

5 Certain expressions must be passed from the ANDF Producer 208 to the ANDF Installer 218, 228 for 

evaluation. For example, expressions like "a n -i-6 that involve computation with values of characters must be 
passed to the ANDF Installer 218, 228. In general, any expression involving machine dependencies must be 
deferred to the ANDF Installer 218, 228. But a constant expression such as 3 + 5 which is guaranteed to fit 
in the minimum range specified for TYPE_JNT may be folded by the ANDF Producer 208. 

jo <free) is a flag which indicates whether (symid) is freed when the nearest enclosing function is 
terminated. 



2.5.59.2.21. KINDMACRO 

15 

Syntax: SYM <symid> KIND MACRO <free> {number of macro parameters) 

This SYM variation starts the definition of a macro. The macro is defined by HPcode-Plus instructions 

which follow the KIND MACRO SYM HPcode-Plus instruction. The macro is terminated by a matching 

20 KIND END SYM HPcode-Pfus instruction. 

Inside the body of the macro, formal parameters are represented by %1 for the first parameter, %2 for 
the second parameter, and so on. When invoked by a MCAL HPcode-Pfus instruction, the formal 
parameters will be substituted by the corresponding actual arguments. 

The ANDF Producer 208 searches through the compiler intermediate representation 212 for sequences 

25 of HPcode-Plus instructions which repeat. The ANDF Producer 208 can then use the KIND MACRO SYM 

HPcode-Plus instruction to define that repeating sequence of HPcode-Plus instructions as a macro, and 
then call that macro as required with the MCAL HPcode-Plus instruction. 
The foHowing restrictions on the definition and use of macros exist; 
Macros may not be defined within macros. 
30 Macros may not make recursive calls to itself (either directly or indirectly through other macros). 

The number of actual parameters must equal the number of formal parameters. 
The macro definition must appear before its invocation. 
Care must be taken when including labels inside macros. Either labels should be parameters of the 
macro, or else the macro should only be invoked once within a function (because labels must be unique). 
35 <free> is a flag which indicates whether <symid> is freed when the nearest enclosing function is 

terminated. 



2.5.59.2.22. KIND END 

40 

Syntax: SYM <symid) KIND END 

This SYM variation is used to terminate definitions of previous KIND FUNCTION, 

KIND_NEW_CONST, and KIND MACRO SYM HPcode-Ptus instructions, (symid) must match the <symid> 

46 of the terminated SYM HPcode-Plus instructions. 

If the terminated SYM HPcode-Plus instruction was of type KIND FUNCTION, then the scope of the 

function ends and all interior symids associated with the function are freed. 

2.5.59,2.23. KIND SRCFILE 

50 

Syntax: SYM (symid) KIND SRCFILE <langtype) <LOC # of start of code) 

This SYM variation defines characteristics of a source file. If the symbolic debug option is turned on, the 
ANDF Producer 208 must emit this SYM HPcode-Plus instruction at the start of each source file, the start of 

55 each included file, and the return from each included file. Additional KIND SRCFILE SYMs may optionally 

be emitted to the compiler intermediate representation 212 before each KIND FUNCTION SYM HPcode- 
Plus instruction for those languages that permit the turning on and off of debug information within the 
source via compiler options. This guarantees that debuggers can determine the origin of functions. 
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KIND SRCFILE SYM HPcode-Plus instructions must appear before KIND FUNCTION SYM HPcode-Plus 

instructions. 

{"name") may be either absolute or relative names. Names of ANSI-C include files can be given in 
"(filename)" format, 

5 (iangtype) is an integer which indicates a source language, as below: 

0 LANG UNKNOWN 

1 LANG C 

2 LANG F77 

3 LANG PASCAL 
w 4 LANG COBOL 

5 LANG BASIC 

6 LANG ADA 

(LOC # of start of code) is a tine number given by the ANDF Producer 208 to the first line of code 
inside the source file used in the LOC HPcode-Plus instruction. 



75 



2.5.59.2,24, KIND LABEL 



SYM (symid) KIND LABEL <LOC #>< M name rt > 

20 This SYM variation defines a labeL tf the symbolic debug option is turned on, one KIND LABEL SYM 

HPcode-Plus instruction should be emitted for each source program statement label, 
("name") is the name of the label. 

(LOC #) is the line number associated with the label used in the LOC HPcode-Plus instruction. 

25 2.5.59.3. Incomplete Declarations 

The ANDF Producer 208 may generate incomplete KIND ARRAY, KIND STRUCT, KIND UNION, 

and KIND ENUM SYM HPcode-Plus instructions. That is, the array size or first field or first member may 

not be defined, in such cases, the ANDF Producer 208 generates a first SYM instruction with a placeholder 
30 value of 0. Later, when the ANDF Producer 208 has more complete information, a second SYM instruction 
of the same kind, using the same symid, is generated to fill in the missing information. Until the second 
SYM instruction is completed, the ANDF Installer 218, 228 is not required to know the size of the data 
object, 

35 2.5.60. TJP - True JumP 

The syntax of HPcode-Plus instruction TJP is presented below: 
TJP <label> 

TJP pops (condition) from the expression stack, (Condition) must be the only item on the expression 
40 stack when TJP is executed. 

TJP causes program control to branch to (label) if (condition) is TRUE. A LAB HPcode-Plus instruction, 
within the current procedure, must define (label). 

2.5.61. UJP - Unconditional JumP 

45 

The syntax of HPcode-Plus instruction UJP is presented below: 
UJP (label) 

UJP causes program control to branch unconditionally to (label). A LAB instruction, within the current 
procedure, must define (label). The expression stack must be empty when UJP is executed. 

50 

2.5.62. XOR - logical exclusive OR 

The syntax of HPcode-Plus instruction XOR is presented below: 
XOR 

55 XOR pops <op1> and (op2> from the expression stack, A logical XOR operation, <op1> XOR <op2X is 
performed to produce a result. The result, having the same data type as <op1> and <op2>, is pushed onto the 
expression stack. 

When (opD and <op2) represent integer or character data values, a bitwise XOR is performed. 
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3 * ANDF Producer 

Figure 11 presents a detailed block diagram of the ANDF Producer 208 of the present invention. The 
ANDF Producer 208 is made up of two components: a Preprocessor 1114 and a Compiler 1122. As shown 
5 in Figure 1 1 , in an alternative embodiment of the present invention the ANDF Producer 208 also includes a 
High-Level Optimizer 1144 and an Archiver/Linker 1154. 

These four components are described in the following sections, 

3.1 . Preprocessor 



The Preprocessor 1114 receives ANSI-C Source files 202 (which contain machine independent 
computer programs), user-defined header files 1102, system-specific header files 1104, and standard 
header files 1 106. 

The Preprocessor 1114 expands object-tike macros and function-Jike macros found in ANSI-C Source 
75 files 202. In other words, the Preprocessor 1114 handles #define and #include directives (and related 
features such as #ifdef). 

An example of the object-like macro is shown below: 
#define NULL 0 

An example of the function-like macro is shown below: 



#define offsetof(_s_name, _m_name) 
( ( s i ze J: ) & ( ( (_s_n ame* ) 0 ) - > jnjiame } ) 

25 

After expansion of object-like macros and function-like macros, the ANSI-C source file 202 is called an 
expanded machine independent computer program. The Preprocessor 1114 places the expanded machine 
independent computer program into a Preprocessed Source file 1118, 

In performing macro expansion and textual substitution, the Preprocessor 1114 makes use of header 
$0 files. These header files can be classified into three categories: 
o user-defined header files 1 102, 
o system-specific header files 1 104, and 
o standard header files 1 106. 
User-defined header files 1102 are created by computer programmers. 8y definition, User-defined 
35 header files 1102 are specific to particular users. 

System-specific header files 1104 are, as the name implies, specific to particular computer platforms 
206, 218, 228. As a general rule, the machine independent computer programs 202 should not contain 
references to System-specific header files 1104 (unless the object-like and function-like macros contained in 
such header files are written in a machine independent manner, and are available on both the native 
40 computer platform 206 and the target computer platforms 216, 226). 

Standard header files 1106 are thoso which are specified by the ANSI-C standard. They are listed 
below. 



(asserth) 


<locale.h) 


(stddef.h) 


(ctype.h) 


(math.h) 


(stdio.h) 


(errno,h) 


<setjmp.h> 


(stdlib.h) 


(float h> 


<Sfgnai.h> 


(string, h) 


(limits.h) 


<stdard.h> 


(time.h) 



Computer platforms 206, 218, 228 must contain complete copies of the standard header files 1106, The 
contents of the standard header files 1106, however, may differ among computer platforms 206, 218, 228, 
For example, object-fike macros, function-like macros, and type definitions which are defined one way on 
one computer platform may be defined differently on another computer platform. Thus, the standard header 
55 files 1106 may be dependent on particular computer platforms 206, 218, 228. Nevertheless, the ANDF 
Producer 208 must accept computer programs 202 that use standard header files 1106 and must ensure 
that the standard header files 1106 behave as if they were compiled at the target computer platforms 216, 
226, 
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The Preprocessor 1114 solves this problem by using a mechanism to defer the translation of macro and 
type definitions found in standard header files 1108 until install time (i.e., until the ANDF Installer 218, 228 
installs the computer program 202 at the target computer platform 216, 226). 

Specifically, all standard header files 1106 are modified by substituting unique key words for data type 
5 identifiers, object-like macro identifiers, and function-like macro identifiers contained In the standard header 
files 1106. In the preferred embodiment of the present system, the unique key words are equal to the data 
type identifiers, object-like macro identifiers, and function-like macro identifiers themselves, with the addition 
of a prefix ANDF ", 

The proposed solution is illustrated in the following example. The standard header file stddef.h (caNed 
w Stddef.h Unmodified for reference purposes) contains the following statements. 

#define NULL 0 
typedef unsigned int size_t; 
is typedef unsigned int wchart; 

typedef unsigned int ptrdifft; 
^define of fsetof(_s_name, jn_name) 
{(si ze_t ) & ( ( (_s_n ame* ) 0 ) - >jn_n ame ) ) 

20 

Identifiers such as "NULL" are called object-like macro identifiers, identifiers such as "size t" are 

called data type definition identifiers. Identifiers such as "offsetof" are called function-like macro identifiers. 
These identifiers are defined in the standard header file stddef.h. 

A modified ANDF version of stddef.h (called Stddef.h Modified for reference purposes) contains the 
25 following statements. 

#define NULL ANDFJ4ULL 

30 



#define size_t _ANDF_size_t 

fdefine wcharjt ANDF_wchar_t 

35 #define ptrdiff_t _ANDF_ptrdiff_t 

#define offsetof (_s name, jn_name) 

ANDF__of f s e t o f ( _s_n a me , jn_n ame ) 

40 Statements such as "#define NULL ANDF NULL" and '^define size_t ANDF size t" are 

called object-like macro definitions. Statements such as "#defme offsetof{J3_ narne - 171 name) 

ANDF offsotof( s name, m name)" are called function -like macro definitions. The object-! iNe macro 

definitions assign unique key words to object-Hke macro identifiers and type definition identifiers. The 
function-like macro definitions assign unique key words to function-like macro identifiers. 

45 The Preprocessor 1114 uses Stddeth Modified for macro expansion. Consider the following program 

excerpt: 



50 
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#include <stddef*h> 

main() 

( 

5 struct s { 

sizej; i; 
wchar_t j ; 
ptrdiffj: p; 

}; 

>o struct s x; 

int a; 

a « offsetof (struct s,j); 
a = NULL; 

75 



A translation of the above program excerpt by the Preprocessor 1114, using stddef.h modified, is 
presented below. The translation is the expanded machine independent computer program. The expanded 
machine independent computer program is placed in the Preprocessed Source file 1118, Object-frke macros 

20 and function-like macros which contain the prefix " ANDF n are called expanded object-like macros and 

expanded function-like macros. 



main() 
{ 

struct s { 

ANDF_size_t i; 

ANDFjwcharJ: j;. 

_ANDF_ptrdiffJ: p; 

}; 

struct s x; 
int a; 

a » ANDF_offsetof (struct s, j); 
a - ~ANDF_NULL; 



The task of the Preprocessor 1114 is complete. We will now consider the operation of the Compiler 
1122 and the ANDF Installer 218, 228 with respect to the processing of standard header files 1106 <the 
Compiler 1122 and the ANDF Installer 218, 228 are further described in Sections 3.2 and 4.0, respectively). 

40 As shown in Figure 11, the Compiler 1122 receives the Preprocessed Source file 1118 as input. As 
described in Section 3.2, the Compiier 1122 translates the expanded machine independent computer 
program contained in the preprocessed source file 1118 into HPcode-Plus instructions. 

The Compiler 1122 knows, however, that it cannot completely translate unique key words {Le, t those 
words beginning with " ANDF "). The translation of unique key words must be deferred to the ANDF 

45 installer 218, 228 (that is, the ultimate interpretation of the data type definitions, the object-like macro 
identifiers, and the function-like macro identifiers are deferred to the AND Installer 218, 228), Therefore, the 
Compiler 1122 translates source code containing unique key words into HPcode-Plus instructions containing 
negative symbolic id's. 

Negative symbolic id's represent place-holders. They are system defined and reserved symbols that 
50 map into the unique key words (which correspondingly map into the object-like and function- like macro 
identifiers). Upon encountering a negative symbolic id, the ANDF Installer 218, 228 exchanges data type 
definition expansions, object-like macro expansions, and function-like macro expansions for the negative 
symbolic ids. The data type definition expansions, object-like macro expansions, and function-like macro 
expansions are defined and dependent upon the target computer platforms 21 6 T 226. 
55 For example, the Compiler 1122 translates the contents of the above Preprocessed Source file 1118 
into the following HPcode-Plus instructions. As shown in Figure 11, these HPcode-Plus instructions are 
stored in the HPcode-Pius Object file 1160. 
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SYM 401 KIND_STRUCT 1 402 0 "s" 

; defining structure s 
SYM 402 KINDJIELD -2 403 M i" 
5 ; defining field i has type -2 * ANDF sizet 

SYH 403 KINO_FIELD -3 404 "j" 

; defining field j has type -3 - _ANDF__wchar_t 
SYM 404 KINDFIELD -4 0 B p» 

; field p has type -4 - _ANDF_ptrdiff_t 
w SYM 405 KINDJ3VAR 4010 "x" 

; defining local variable x as a structure s 
SYM 406 KIND_DVAR TYPEJNT 0 a " 

; defining local variable a 
MCAL -5 401 403 
75 ; calling the macro ANDFoffsetof 

CVT TYPE_INT 

; convert to target type 

STR 406 

; store in "a" 

20 LOD -1 

; load H _ANDF__NULL" 
CVT TYPEINT 
STR 406 

; store in "a" 

25 



The data type definition expansions, and object-like and function-like macro expansions which cor- 
respond to the reserved negative symbolic id's are defined and stored in a standard ANDF header file 
30 called andf.h. Andf.h exists on every install site 216, 226, but its contents might vary from one install site 
216, 226 to another. The contents of andf.h for the modified ANDF version of stddef.h, i.e., Stddef.fi 
Modified, are presented below (Again, the actual contents of andf.h may vary from one install site 216 5 226 
to another. Also, the name of andf.h may vary from one install site 216, 226 to another.). 



35 



40 



45 



SYM -1 KIND^CONST TYPEINT 1 n ANDF_NULL M 

; define NULL as an int constant 1 
SYM -2 KINDJIODIFIER 0 0 TYPEJJNSJNT n _ANDF_sizeJt tt 

; define size_t is unsigned int 
SYM -3 KINDJIODIFIER 0 0 TYPEJJNS^INT "_ANDF_wchar_t" 

; define wchart is unsigned int 
SYM -4 KINDJIODIFIER 0 0 TYPEJiNS„INT "_ANDF„ptrdi f ft' 

; define ptrdifft is unsigned int 

SYM -5 KINDJfACRO 0 2 " ANDF of f setof M 

; define offsetof macro 
SYM -500 KIND_POINTER 0 %1 

; create a pointer type 



LDC TYPE_INT 0 
5 0 CVT -500 

IXF %2 



; load constant 0 

; typecast pointer to the structure 
; create field address 

CVT -2 

55 ; typecast addr. to the size__t type 



SYM ^5 KINO END 



; end offsetof macro 
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35 



The ANDF Installer 218, 228 substitutes negative symbolic id's with appropriate data type definition 
expansions- and object-Hke and function-like macro expansions by referring, upon encountering a negative 
symbolic id, to andf.h (in this capacity, the ANDF Installer 218, 228 is acting like a preprocessor). The 
translation of the above HPcode-Plus Object file 1160 by the ANDF Installer 218, 228 is presented below. 



defining structure s 







401 1 




SYM 


402 i 


w 








SYM 


403 1 




SYM 


404 1 


75 


SYM 


405 1 










LDC 


TYPE 


20 








CVT 


KIND 




IXF 


403 




CVT 


TYPE 


25 


CVT 


TYPE 




STR 


406 


30 


LOD 


1 






STR 


406 



defining field i has type = unsigned integer 



defining field j has type - unsigned integer 
)_FIELD TYPEJJNSJNT 0 H p" 
field p has type unsigned integer 
)J)VAR 4010 H x H 

defining local variable x as a structure s 
3J5VAR TYPEINT 0 "a" 
defining local variable a 

r o 

expansion of offsetof macro begins 
0 INTER 0 401 

INS_INT 

; end of offsetof macro expansion 
NT 

; convert to target type 

; store in M a" 

; load " ANDF NULL" 



store in "a" 



Structure type definitions are similarly handled. For example, the div t type in (stdlrb.h) is defined as 

follows. 



40 



typedef struct { 

int quot; 

int rem; 
} div_t; 



45 



50 



55 



The corresponding HPcode-Plus definition in andih is presented below. 
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SYM -10 KINDJ5TRUCT 0 -11 0 "divj:" 

; define div_t struct 

SYM -11 KINDER ELD TYPE_INT -12 "quot" 

; define quot field 

SYM -12 KIND_FIELD TYPE_INT 0 Vein" 

; define rem field 

For the following code: 

struct divjt x; 
. . x.quot . . 

The Compiler 1122 generates the following HPcode-Plus instructions. Again, these instructions are 
pfaced in the HPcode-Plus Object file 1160. 



SYM 406 KIND-DVAR -10 0 "x" 

; defining local variable x as a divt struct 

IDA 406 

IXF-11 

ROD 



The typedef of div__t may be different on different computer platforms. The ANSI-C standard requires 

that div t have two fields, "quot" and "rem", but the order is implementation defined. Since the HPCode- 

30 Plus symbolic ids are standardized, however, the ANDF statements to reference the field "x.quot* is the 
same on all computer platforms. Consider the following div_j definition on a different computer platform: 

typedef struct { 
35 int rem; 

int quot; 
} div_t; 



40 The corresponding ANDF definition in andf.h contains the following statements. 

SYM -10 KINDSTRUCT 0 -12 0 "div t" 

; define divt struct 
-* SYM -12 KINDFIELD TYPE_INT -11 "rem" 

; define rim field 

SYM »U K1ND_FIELD TYPE INT 0 "quot" 

; define quot field 

so 

Note that the same HPcode-Plus instructions presented above can be osed to reference "x.quot" on 
this computer platform. 

A related issue is that some standard functions are defined as function-like macros on some computer 
platforms 206, 216, 226 but not on others. The ANSI-C standard aifows certain library functions to be 
55 implemented either by a real function or a function-like macro. For example, abs{) can either be a function 
or a function-like macro. 

At the Producer site 206 : such library function names must be replaced by unique keywords using 
function-like macro definitions in the modified ANDF version of the header file. At the Installer site 216, 226, 
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the andf.h file would contain an HPcode-Pius macro expansion for the reserved negative symbolic id (of the 
unique keyword) defining it either as a function call or as a HPcode-Pius instruction sequence for the local 
macro definition. 

For example, suppose the following function-like macro definition was inserted into the modified ANDF 
5 version of macros.h (called Macros.h Modified for reference purposes), 
^define abs() ^ANDF abs(x) 

Assume the Producer 208 maps the unique keyword " ANDF absix)" to the negative symbolic 

identifier -200, 

The compiler intermediate representation 212 which contains the negative symbolic identifier -200 is 
w then distributed to the Install site 216 and the Install Site 226. For the purposes of this example, suppose 
that the Install Site 216 defines abs as a macro- The Install Site 226 defines abs as a function. 

The andf.h file at the install Site 216 would then contain the following HPcode-Plus macro expansion: 

SYM -200 KINDJ1ACR0 01 " AN0F_abs H 

15 IDC TYPE__INT 0 

L0D %l 
GEQ 
CEVL 
L0D %\ 

20 CEVL 

L0D %1 
NEG 
CEXP 

SYM -200 KIND END 

25 — 

The andf.h fiie at the Install Site 226 would then contain the following HPcode-Pius macro expansion: 

30 SYM -200 KIND HACR0 0 1 " ANDF abs" 

MST ~ 
L0D %l 
PAR 

CUP $ym_id_for_abs 
SYM -200 KIND END 



3.2. Compiler 

40 

As shown in Figure 11, the Compiler 1122 receives the Preprocessed Source file 1118 as input The 
Compter 1122 translates the expanded machine independent computer program, contained in the 
Preprocessed Source file 1118, into sequences of HPcode-Pius instructions. These HPcode-Plus instruc- 
tions are stored in the HPcode-Plus Object file 1160. The HPcode-Pius Object file 1160 contains the 
45 compiler intermediate representation 212. 

As presented in Figure 12, the Compiler 1122 is composed of three stages, a Scanner/Parser 1124, 
1126, a Semantic Analyzer 1128, and a Code Generator 1130. These three stages are described in Sections 

3.2.1, 3.2.2, and 3.2.3, respectively. 

so 3 2 A . Scanner/Parser 

The Scanner/Parser 1124, 1126 buitds an abstract syntax tree 1204 (AST) in accordance with tree- 
building rules which can be specified in the input grammar. The AST 1204 essentially models the structure 
of the computer program 202 being compiled- The AST 1204 is composed of subtrees which represent 
55 declarations, function definitions, statements, expressions, etc. 

3.2.2. Semantic Analyzer 
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As shown in Figure 12, the Semantic Analyzer 1128 receives the Abstract Syntax Tree 1204 as input. 

The Semantic Analyzer 1128 creates a Symbol Table 1134 and a Type Table 1138. The Semantic 
Analyzer 1128 stores symbolic identifiers, symbolic information, and symbolic kind information from SYM 
HPcode-Plus instructions in the Symbol Table 1134 and the Type Table 1138. 
5 The Semantic Analyzer 1128 decorates the nodes of the AST 1204 with pointers to appropriate Symbol 

Table 1134 and Type Table 1138 entries to produce a Decorated Abstract Syntax Tree 1210. 

3,2,3. Code Generator 

io As shown in Figure 12, the Code Generator 1130 receives the Decorated Abstract Syntax Tree 1210 as 
input. The Code Generator 1 130 writes its results to the HPcode-Plus Object file 1 160. 

Code generation is performed while traversing the decorated AST. During this traversal source 
language (i.e., Pascal, C, Ada, etc.) operations, types, and control constructs are mapped into HPcode-Plus 
instructions. The recursive tree traversal is performed by visiting the nodes in preorder as shown below: 

75 <Root-node> (leftmost-child node) ... (rightmost-child node) 

The appropriate HPcode-Pius instruction sequence is generated as each node is visited. The basic 
mapping of ANSl-C to HPcode-Plus is a straightforward process. Most of the expression operators in C 
have corresponding HPcode-Plus instructions. C control structures are built out of labels and the TJP, FJP, 
and UJP HPcode-Plus instructions. 

20 The mapping of ANSi-C to HPcode-Plus in an architectural neutral manner is often complex. These 
complexities are described in the following sections, in reading these sections, it may be helpful to refer to 
Figure 3, which presents the HPcode-Plus instruction set for ANSI-C. 

3.2.3.1. Data Memory Allocation 

25 

Data memory allocation is a major problem in producing an architecture neutral distribution format. in 
traditional compilers 106, frontends 108 allocate memory for data. But since computer platforms have 
different word sizes, packing algorithms, alignment requirements, and data type representations, data 
memory allocation by the frontend 108 produces compiler intermediate representations 112 which are not 
30 architecturally neutral. 

In the present invention, the Code Generator 1 130 makes no assumptions on how data objects map into 
the memory of the target computer platform 216, 226. Instead, data memory allocation is deferred so that 
word sizes, packing algorithms, storage and alignment requirements, and data type representations are 
determined by the ANDF installer 21 8 ; 228, rather that the ANDF Producer 208. 

35 The Code Generator 1130 uses the SYM HPcode-Plus instruction to defer data type, variable, and 
function definition and declaration to the ANDF Installer 21 8 : 228. In deferring such memory allocation tasks 
to the ANDF Installer 218, 228, the Code Generator 1130 uses the SYM HPcode-Plus instruction to give 
unique symbolic identifiers to data type identifiers, variable identifiers, and function identifiers. 

For example, suppose the machine independent computer program 202 contains the following memory 

40 allocation instructions: 
int x; 

double y{); 

x and y are variables. If x is a dynamic variable, then the Code Generator 1130 would use the following 
SYM command to assign a unique symbolic identifier to x: 
45 SYM 100 KIND DVAR TYPE INT 0 "x" 

The Code Generator 1130 could then translate memory reference instructions {such as "x = 1;" and "z 
= x + y;") which contain the variable x to HPcode-Plus instructions by using the unique symbolic identifier 
1 00 to refer to x. 

Thus, via the SYM HPcode-Plus instruction, the Code Generator 1130 provides memory allocation 
so information to the ANDF installer 21 8 ; 228. The ANDF Installer 218, 228 uses this information to map 
memory allocation instructions into the memory of the target computer platform 216, 226. 

3- 2 3 - 2 - Sc °P e - Link age> and Declaration of Variables 

55 The Code Generator 1130 determines the scope and linkage of variables, providing names for those 
variables with external linkage. The ANDF Installer 218, 228 assumes that the scoping and linkage 
specification of the HPcode-Plus Object file 1160 is correct 

The Code Generator 1130 uses the SYM HPcode-Plus instruction to deciare variables. Variable types 
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depend on the value of the <symkind> field of the SYM instruction {see Figure 10). Static storage duration 

variables (KIND SVAR), automatic local variables {KIND DVAR), and parameter variables 

(KIND FPARAM) are defined. 

If KIND SVAR variables have external linkage, a visible name is supplied with the SYM declaration. 

5 The Code Generator 1130 also uses the SYM HPcode-Plus instruction to define and declare functions. 

Function definitions (KIND FUNCTION) and function declarations (KIND FUNC DCL) include visible 

names if the linkage is external. 

The Code Generator 1130 uses the SYM HPcode-Plus instruction to declare data type constructors, 

such as arrays, structures, and pointers. The KIND ARRAY, KIND_STRUCT S KIND_UNION, 

io KIND_FIELD, KIND___POINTER, KIND FUNC_PTR, KIND_ENUM, and KIND_MEMBER declarations 

specify the constructed C data types. In addition, the "const" and "volatile" C qualifiers are added by using 
the KIND MODIFIER declaration. 

The basic data types for C are predefined in the HPcode-Plus specification. The Code Generator 1130 
is responsible for determining whether a plain char or a plain bit field is signed or not. 

75 

3.2.3.3. Constants 

3.2.3-3.1. Floating Point and Integer Constants 



20 To avoid problems of different floating-point representations, the Code Generator 1130 represents 
floating -point constants in HPcode-Plus using the characters provided in the source file 202. The Code 
Generator 1130 may make minor changes, provided that the changes do not result in any change in 
interpretation. 

For example, if 5.31 e1 is a floating-point constant in the source file 202, then the Code Generator 1130 
25 may specify the constant In HPcode-Plus as 5.31E + T The Code Generator 1130 cannot, however, convert 
the constant to its internal representation and then output 53.0999995 to the HPCode-Plus Object file 1 160. 

Similarly, the Code Generator 1130 may change the format of integer constants as long as the 
semantics remain identical. For example, the Code Generator 1130 may decide to translate all octal 
constants to their corresponding hexadecimal representations. 
30 in all cases, the Code Generator 1130 must supply floating-point and integer constants to the HPcode- 
Pius Object file 1160 because the floating point and integer constants may be representable on the target 
computer platform 216, 226. 

3.2.3.3.2. Enumeration Constants 

35 

The Code Generator 1130 represents enumeration constants as simple integers. For symbolic debug 

purposes, however, the Code Generator 1130 may use the KIND MEMBER symbol declaration to specify 

enumeration constants. 

40 3.2.3.3.3. Character Constants 



The HPcode-Plus Object file 1160 is an ASCII file. Thus, in creating the HPcode-Pfus Object file 1160, 
the Code Generator 1130 represents all ASCII character constants and strings in a natural way. For 
example, the Code Generator 1130 uses the following command to load the character "a" into the 
46 expression stack. 

LDC TYPE CHAR "a" 

The Code Generator 1130 represents simple escape sequences by using their equivalent ASCII 
characters, 

The Code Generator 1130 represents octal or hexadecimal escape sequences by using the integer 
so value of the sequences. For example, the Code Generator 1130 uses the following command to Joad the 
hexadecimal escape sequence "\xlb" into the expression stack. 
LDC TYPE CHAR 27 

The difficulty comes when the source character set has a character that is not representable as an 
ASCII character (the unrepresentable character is hereinafter referred to as "CH"). One solution that works 
55 as long as the ANDF Producer 208 and ANDF Installer 218, 228 are using the same character set is for the 
Code Generator 1130 to put the value of the character CH (using the character set of the native computer 
platform 206) into the HPcode-PJus Object file 1160 as an integer. The ANDF Installer 218, 228 would 
detect the integer and treat it as a character code. 
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This scheme does not work, however, if the ANDF Producer 208 and ANDF Installer 218, 228 are using 
different character sets that nevertheless share some characters. In this case, there must be a mechanism 
to allow the Code Generator 1130 to specify a source character set designator in the HPcode-Plus Object 
file 1160. 

5 In the present invention, this problem is solved by defining a list of character sets that both the ANDF 

Producer 208 and the ANDF installer 218, 228 recognize. For example, if T specifies a character set of the 
native computer platform 206, and character CH has a character code 101 in the T character set, then the 
ANDF Producer 208 represents CH in the HPcode-Plus Object file 1160 as Z'101. This mechanism also 
works for multi-byte characters. 

70 

3.2.3.4. Data Conversions 



The data type of a data object may not be readily apparent. For example, in the source code 
expression: 

y = x + 37000; 



the Code Generator 1130 may not know if 37000 is an integer or a long integer. 

The Code Generator 1130 uses the CLDC HPcode-Plus instruction to handle those instances when the 
20 data type of a large integer constant is not definitely known. In the previous example, the Code Generator 
1130 woufd generate the following HPcode-Plus instruction. 
CLDC 0 37000 

When mapping this HPcode-Pius instruction to the target computer platform 216, 226, the ANDF 
Installer 218, 228 would attempt to treat 37000 as an integer. If 37000 cannot be represented as an integer, 
25 then the ANDF Installer 218, 228 would treat 37G00 as a long integer. 

In addition to CLDC, the Code Generator 1130 uses the CVT HPcode-Plus instruction for implicit type 
conversions, known integral promotions, and known arithmetic conversions. The Code Generator 1130 uses 
the ICVT HPcode-Plus instruction for integral promotion of operands where the destination type is not 
known. Also, the Code Generator 1130 uses the ACVT HPcode-Plus instruction for arithmetic conversions 
30 where the destination type is not known. 



3.2.3.5. Postfix Expressions 

The Code Generator 1130 uses the IXE HPcode-Plus instruction for array subscripting. The IXE 
35 HPcode-Plus instruction returns the address of an array element. This array element address is then used 
in subsequent ILOD and ISTR HPcode-Plus instructions (or as the source of another IXE HPcode-Plus 
instruction in the case of multiple dimension arrays). 

The Code Generator 1130 uses MST, CUP, and ICUP HPcode-Plus instructions to map C language 
function calls, The MST HPcode-Plus instruction marks the expression stack in preparation for a procedure 
40 call. The MST HPcode-Plus instructions are paired with CliP (call procedure) or ICUP (indirect call) 
HPcode-Plus instructions. The Code Generator 1130 must ensure that such pairs are properly nested. 

The Code Generator 1130 uses PAR HPcode-Plus instructions to specify parameters for the nearest 
enclosing MST/CUP or MST/ICUP pair. The Code Generator 1130 is responsible for performing type 
conversions on parameters before the PAR HPcode-Plus instruction. 
45 The Code Generator 1130 uses the IXF HPcode-Plus instruction to reference fields of a structure or 

union. 

The Code Generator 1130 uses a combination of DUP, INC, and the load and store HPcode-Plus 
instructions to map C language increment and decrement operations. For example, the Code Generator 
1130 maps the source code expression *p + + to the following HPcode-Plus instructions' 

50 

L0D <p> 
DUP 
INC 1 

55 STR <p> 

ILOD 
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3.2.3-6. Unary Opera tions 

The Code Generator 1130 maps ANSI-G language increment and decrement unary operators in a 
manner similar to their corresponding postfix operators. The resulting HPcode-Plus instructions are usually 
5 simpler since modified values are used (rather than original values). 

The Code Generator 1130 uses the LDA HPcode-Plus instruction to map the C language unary & 
operator. 

The Code Generator 1130 uses either the ILOD or ISTR HPcode-Plus instruction to map the C language 
* operator, depending on whether the result is being used in an expression or being assigned to a variable. 
w The Code Generator 1130 uses the appropriate integral promotion conversion HPcode-Plus instruction 
to map the C language unary + operator. 

The Code Generator 1130 uses the NEG HPcode-Plus instruction to map the C language unary - 
operator. 

The Code Generator 1130 uses the NOT HPcode-Plus instruction to map the C language " HPcode- 
15 Plus instruction. 

In mapping the C language ! operator, the Code Generator 1 130 tests against 0 by using a sequence of 
HPcode-Plus instructions that are equivalent to IE and (0= = E). 

The Code Generator 1130 uses the SYM HPcode-Plus instruction to map the C language "sizeof" 
operator. Following the sizeof operation, the Code Generator 1130 determines the type of the result. 
20 The Code Generator 1130 uses the CVT HPcode-Plus instruction to map explicit C language cast 
operations. 

3.2.3,7. Other Operators 

25 The Code Generator 1130 uses the MPY ( DIV, and REM HPcode-Plus instructions to map the C 

language multiplicative operators (i.e„ \ f t and %). HPcode-Plus defines the semantics of DIV and REM 
when applied to negative integers to ease implementation by the ANDF Installer 218, 228 and to provide a 
uniform interface for computer programmers. 

The Code Generator 1130 uses the ADD and SUB HPcode-Pius instructions to map the C language 
30 additive operators (i.e., + and -). In addition, the Code Generator 1130 uses the HPcode-Plus instructions 
!XE (also used in array subscripting), (NC S and SUB to map C language pointer arithmetic operations. 

The Code Generator 1130 uses the SHFT HPcode-Pius instruction to map the C language shift 
operators (i.e., <^ and ^> ). The semantics of the shift, if the shift amount is greater than or equal to the size 
of the data object, is left to the ANDF Installer 218, 228. HPcode-Plus specifies that negative signed 
35 numbers shifted right are sign extended. 

The Code Generator 1130 maps the C language relational and equality operators < 5 >,< = ,>=, = = 
and to HPcode-Plus instructions IES, GRT, LEQ, GEQ, EQU and NEQ f respectively. 

The Code Generator 1130 maps the C language bitwise operators &&, *\ and | to HPcode-Plus 
instructions AND, XOR, and IGR f respectively. 
40 The Code Generator 1130 uses a CEVL HPcode-Pius instruction to separate the conditionally evaluated 

clauses in the C language conditional evaluation operators (i.e., && and j| ). CEVL is used for the same 
reason for the operator pair ? After the clauses are separated, the Code Generator 1130 issues the CEXP 
HPcode-Plus instruction. 

The Code Generator 1130 uses HPcode-Plus store instructions (STR, ISTR, INST) to map simple C 
45 language assignment statements. The Code Generator 1130 maps compound C language assignment 
statements by using DUP to duplicate the address of the left hand side (so that it is only evaluated once). 
Then the binary operation is performed and the result stored. 

For example, the Code Generator 1130 generates the following HPcode-Plus instructions to represent 
the C language statement a[i] + = j (assuming a is an array of type int): 

so 



ss 
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IDA <a> 
LOD <i> 
IXE TYPEINT 

s DUP duplicate the address of a[i] 

HOD 
LOD <j> 
ADO 
ISTR 



For the C language comma operator and expressions that only have side-effects (such as p +■ + ;), the 
Code Generator 1130 uses the HPcode-Plus DEL instruction to delete a computed item from the expression 
stack. 

75 

3.2.3-8. Folding of Constant Expressions 

The Code Generator 1130 must cautiously perform constant foldings. Constant expressions must be 
folded using the rules of the target computer platform 218, 226, 
20 For example, overflow will result if the Code Generator 1130 on a 18-bit machine is folding a 20000 + 
20000 signed integer expression. 

Another example involves floating-point constant folding. Different computer platforms 206, 21 6 S 226 use 
different floating-point representations with different precisions. Conversion causes loss of precision. 

The third example involves character constant folding. An expression 'a 1 + 5 cannot be folded because 
25 'a 1 may represent different values on different computer platforms 206, 216, 226. 

In general, constant folding decisions (including the values, internal representations, and ranges of 
constant expressions) should be deferred to the ANDF Installer 21 8 t 228. The Code Generator 1130 may 
safely perform constant foldings on integer expressions whose values are within the minimum range 
specified by the ANSI-C. For example, 3 + 5 is safe. 
30 To defer constant foldings to the ANDF Installer 218, 228, the Code Generator 1130 uses the SYM 

HPcode-Plus instructions with the KIND NEW CONST symbol kind value to assign unique symbolic 

identifiers to constant expressions. For example, the Code Generator 1 130 generates the following HPcode- 
Plus instructions to represent the C language expression: int i[ r a T + 5],k[ r a' +5]; 



SYM 401 KIND^NEW CONST 0 
LDC TYPEINT 'a' 
LDC TYPEJNT 5 
ADD < 

40 SYM 401 KIN0END 

SYM 402 KIND ARRAY 0 #401 TYPE INT 0 



SYM 403 KIND_SVAR 0 402 0 ' i ' 
SYM 404 K1ND_SVAR 0 402 0 'k' 

so The unique symbolic identifier 401 represents the expression T a T +5. Subsequent HPcode-Plus instruc- 

tions would use the unique symbolic identifier 401 to refer to the constant expression 'a' + 5. 

3.2.3.9. Initialization 

55 The Code Generator 1130 uses the HPcode-Plus INIT instruction, coupled with the KIND CONST and 

K!ND_NEW_CONST forms of the SYM HPcode-Pius instruction, for the initialisation mechanism. The 
Code Generator 1130 is responsible for providing a fully-bracketed KIND_CONST specification in the 
HPcode-PJus Object file 11 60. 
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3.2.3.10. Statements 

The Code Generator 1130 uses the HPcode-Plus Instructions LAB, TJP : and UJP to map C language 
labels, conditional branches, and unconditional branches. In addition, the Code Generator 1130 uses the 
s HPCode-Plus instructions CSJP and CTAB to map C language switch statements. 

The Code Generator 1130 does not select the manner in which branching is implemented. Instead, the 
CSJP HPcode-Plus instruction lets the ANDF installer 218, 228 determine which implementation strategy 
(e.g. branch table, cascaded-if s binary search, etc.) is "best" for the target computer platform 216, 226. 

w 3,2.3.11, Functions 

The Code Generator 1130 uses the SYJvl HPcode-Plus instruction to define and declare functions. 

Function definitions (KIND FUNCTION) and function declarations (KIND FUNC DCL) include visible 

names if the linkage is external. 
is The Code Generator 1 130 uses the HPcode-Plus instructions ENT and END to define function entry and 
exit points. The Code Generator 1130 uses the RET HPcode-Plus instruction for internal return statements 
and the STFN HPcode-Plus instruction to specify return values. 

3.2.3.12. Example 

An example ANSI-C source program and its corresponding translation to HPcode-Plus instructions is 
shown in Figures 14 and 15, respectively. 

In Figure 15, variable names, opcode mnemonics, and instruction parameter names are provided for 
readability. The <stdio.h) file used to compile the ANSI-C source program defined "stdout 11 to be T & iob[1]\ 

3.3. High-Level Opt i mizer 

As shown in Figure 11 s the High-Level Optimizer 1144 receives the HPcode-Plus Object file 1160 as 
input. The High-Level Optimizer 1144 reads the HPcode-Plus instructions, computes performance-improving 
transformations on the HPcode-Plus instructions, and outputs an optimized version of the HPcode-Plus 
Object file 1 1 60. 

The HPcode-Plus compiler intermediate language preserves most of the data flow and control flow 
information needed by the High-Levef Optimizer 1144. The only information obscured are the high-level 
loop structures, which can be reconstructed through interval analysis- 

The HPcode-Plus compiler intermediate language also allows machine independent IL-to-JL optimiz- 
ations, such as stack height reduction, operator simplification, constant propagation, procedure inlining, 
redundant definition elimination, and register promotion. 

The High-Level Optimizer 1144 can be implemented with varying degrees of sophistication. The scope 
of the transformations could be confined to individual basic blocks or span procedure boundaries. 

There are at least four distinct advantages for having the High-Leve! Optimizer 1144 separate and 
independent from the Compiler 1122. If the High-Level Optimizer 1144 is separate, then the Righ-Level 
Optimizer 1144 can repeatedly optimize the HPcode-Plus Object file 1160. Repeated optimizations will often 
expose optimization opportunities that would otherwise be missed (such as redundant definitions). 

Second, if the High-Level Optimizer 1144 is separate, the High-Level Optimizer 1144 can be imple- 
mented by using compiler optimization technology from other programming languages. 

Third, by implementing the High-Level Optimizer 1144 separately, the machine resource utilization for 
HPcode-Plus production and installation is minimized. 

Fourth, optimized HPcode-Plus Object files 1160 are harder to decipher and thus provide an extra 
degree of protection for proprietary information in the source file 202. 

3.4. Archiver/Linker 



The Archiver/Linker 1154 archives or concatenates multiple HPcode-Plus object files 1150, 1160 to 
produce an HPcode-Plus archive file 1158 or a Linked HPcode-Plus file 1170, respectively. The HPcode- 
55 Plus object file 1160, the HPcode-Plus archive file 1158, and the Linked HPcode-Plus file 1170 can be 
distributed to target computer platforms 216, 226. 

The Linked HPcode-Plus file 1170 is a concatenation of multiple HPcode-Plus object files 1150, 1160. 
The Archiver/Linker 1154 is not a linker, it does not resolve unbound references among the HPcode-Plus 
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object files 1150, 1160 being concatenated. Rather, the Archiver/Linker 1154 provides the computer 
programmer with the convenience of concatenating multiple HPcode-Plus object files 1150, 1160. 

At target computer platforms 216, 226, the HPcode-Plus Object files 1150, 1160 concatenated into the 
Linked HPcode-Plus file 1170 are extracted before installation {by the ANDF Installer 218, 228) and linking 

(by the native linker). The Archiver/Linker 1154 optionally inserts an OPTN PROGRAM FILE HPcode-Plus 

instruction indicating the name to be given to the fully bound program at the install site 21 6, 226, 

The HPcode-Plus archive file 1158 is analogous to the traditional UNIX archive file produced using the 
"ar" utility. The HPcode-Plus Object files 1160 deposited into the HPcode-Plus archive file are extracted, 
installed, and archived into a standard library file at the target computer platform 216, 226. The resulting 
library file is then searched as usual for resolving references by a native linker on the install site 216 ; 226. 
All system-specific libraries on the native computer platform 206 used by computer programs 202 must be 
translated into HPcode-Plus archive files and provided to the target computer platforms 216, 226. 
Like the High-Level Optimizer 1144, the Archiver 1154 is high-level language independent. 

15 4. ANDF Jn^tajler 

A high-level block diagram of the ANDF Installer 218, 228 is presented in Figure 13- In the preferred 
embodiment of the present investion, the ANDF Installer 218, 228 is composed of four components, a Tuple 
Generator 1304, a Low-Level Code Generator 1322, a Register Allocator 1344, and an Object File Generator 
1358. 

HPcode-Plus Archive files 1158 and Linked HPcode-Plus files 1170 in Figure 11 are distributed from the 
producer site 206 to the install sites 216, 226. At the install sites 21 6, 226, the HPcode-Plus Object files 
1150, 1160 are extracted. Such extraction can be performed by an additional ANDF Installer component (not 
shown in Figure 13), or independent of the ANDF Installer 218, 228 through a standard utility such as the 
UNIX utility "ar". 

Alternatively, the HPcode-Plus Object files 1150 s 1160 can be distributed from the producer site 206 to 
the install sites 216, 226. 

In an alternative embodiment of the present invention, the ANDF Installer 218, 228 is composed of six 
components, the Tuple Generator 1304, the Low-Level Code Generator 1322, a Low-Level Optimizer 1334, 
the Register Allocator 1344, a Machine Specific Optimizer 1352, and the Object File Generator 1358. 

Descriptions of the Tuple Generator 1304, the Low-Level Code Generator 1322, the Low-Level 
Optimizer 1334, the Register Allocator 1344, the Machine Specific Optimizer 1352, and the Object File 
Generator 1358 are presented in the following sections. 

Actual implementation of these ANDF Installer components depends on the particular architecture of 
each target computer platform 216, 226. Thus, the following descriptions were written at a high-level so that 
they would be useful as a guide for implementation on a variety of target computer platforms 216, 226. 

4.1. Tuple-Generator 



40 The Tuple Generator 1304 reads HPcode-Plus instructions from the HPCode-Plus Object file 1150, 
1160. The Tuple Generator 1304 translates HPcode-Plus instructions, which operate on the HPcode-Plus 
virtual machine, into a linear list of machine independent quadruples 1318. 

HPcode-Plus instructions pop their operands from and push their results to the expression stack. Thus, 
HPcode-Plus instructions are stack-based instructions. 

45 The primary difference between HPcode-Plus instructions and the quadruples 1318 is that the implicit 
operands of the stack-based HPcode-Plus instructions are explicitly expressed as operands of the quadru- 
ples 1318. 

In its simplest form, the quadruples 1318 have the following format: 
<opcode> <src1) (src2> <tgt> 

so In general, <opcode) specifies a non-SYM HPcode-Plus opcode. <srd>, <src2>, and <tgt> specify the 
operands of the quadruple. Specifically, <src1> and <src2) specify source operands and <tgt) specifies a 
target operand. 

Interpretation of the quadruple operands depend on the value of (opcode). For example, a UJP 
quadruple has no source operands and the target operand is the label identifying the branch destination, 
55 Also, some HPcode-Plus instructions do not translate into quadruples (e.g,, DEL) while others may translate 
into multiple quadruples (e.g., MCAL). 

To translate HPcode-Plus instructions into the quadruples 1318, the Tuple Generator 1304 models the 
expression stack. Each HPcode-Plus instruction pushes or pops values from the expression stack, The 
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Tuple Generator 1304 determines the vaiue of quadruple operands by identifying those expression stack 
elements which would be referenced by the HPcode-Plus instruction in question, 

(n addition to quadruple generation, the Tuple Generator 1304 builds a Symbol Table 1312 and a Type 
Table 1306. The Tuple Generator 1304 enters items into these tables while processing HPcode-Plus SYM 
5 instructions. 

The Symbol table 1312 contains entries for variables, function definitions and declarations, function 
formal parameters, constants, and macros defined by SYM instructions as well as labels defined using the 
LAB instruction. The folding of constant expressions is completed at this point. That is, the Tuple Generator 
1304 evaluates constant expressions {defined using the KIND NEW CONST SYM instruction) before 

10 entering the constants mto the Symbol Table 1312. The Tuple Generator 1304 also enters into the Symbol 
Table 1312 those temporaries which are produced by operations on the expression stack. 

The Type Table 1306 contains entries for the various data type and structure field SYMs as well as the 
predefined data types supported by HPcode-Plus. Quadruple operands can be represented by pointers to 
the corresponding Symbol Table entries. Symbol Table entries in turn reference the appropriate Type Table 

75 entries. 

While generating quadruples, the Tuple Generator 1304 uses the Symbol Table 1312 to complete the 
expansion of object-like macros and function-like macros (as described above). 

The Symbol Table 1312 and the Type Table 1306 are extensively used by the Low-Level Code 
Generator 1322 for memory allocation and instruction selection. 
20 By doing quadruple generation and low-ievel code generation on a procedure by procedure basis, the 
ANDF Installer 218, 228 can delete those entries in the Symbol Table 1312 and the Type Table 1306 that 
have inaccessible scopes. In particular, the Symbol Table entries for variables and types local to a function 
can be removed after code for that function has been generated. 

25 4.2. Low- Level Code Generator 



The Low-Level Code Generator 1322 is invoked after the quadruples 1318 are generated for each 
HPcode-Plus instruction in the HPcode-Plus Object file 1150, 1160. it receives the Quadruples 1318 as 
input and produces a Low-Level Compiler Intermediate Representation 1338 (hereinafter referred to as the 
30 Low-Level CIR), 

The Low-Level CIR 1338 is analogous to the compiler intermediate representation 212 that is produced 
by the Code Generator 1130 and stored in the HPcode-Plus Object file 1160. The Low-Level CIR 1338, 
however, is not architecturally neutral. Instead, the Low-Level CIR 1138 is dependent upon the particular 
architecture of the target computer platform 216, 226. 
35 Specif icatiy, the Low-Level Code Generator 1322 translates the machine independent quadruples 1318 

into a machine specific compiler Intermediate representation 1338. As part of this translation process, the 
Low-Level Code Generator 1322 performs the following tasks. 

4.2.1. instruction Selection 

40 

The Low-Level Code Generator 1322 selects a sequence of instructions from the target computer 
platform's instruction set to represent each quadruple 1318. 

While selecting instructions, the Low-Level Code Generator 1322 considers a number of factors, such 
as the alignment restrictions of the target computer platform 216, 226 and the desired exception handling 
45 behavior. The actual configuration of the target computer platform 216, 226 also impacts instruction 
selection. This is especially true when dealing with different implementations of a single architecture such 
as the Motorola MC680xx family. 

The Low-Level Code Generator 1322 uses a Machine Configuration file 1328 to solve this problem. The 
precise contents of this file are architecture specific, and include register file sizes, coprocessor availability, 
so and instruction cycle times. 

The Low-Level Code Generator 1322 must effectively use the target machine's instruction set to ensure 
good code quality. Reduced Instruction Set Computer (RISC) architectures, for example, require shorter 
instruction sequences for better code quality. Conversely, for CISC computer platforms, where instructions 
have differing cycle times, short instruction sequences may not produce the most efficient code. Thus, 
55 generating optimal code sequences for any architecture is a complicated task which is highly dependent on 
the operands used. Thus, the Low-Level Code Generator 1322 may use a table driven approach, 

4.2.2. Memory Allocation 
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With the HPcode-Plus compiler intermediate language, memory allocation is performed by the ANDF 
Installer 218, 228 rather than the ANDF Producer 208. Specifically, the Low-Level Code Generator 1322 of 
the ANDF Installer 218, 228 performs memory allocation. 

The Low-Level Code Generator 1322 uses the Symbol Table 1312 and the Type Table 1306 to bind 
5 data objects to the target computer's physical memory. Specificaffy, the Low-Level Code Generator 1322 
binds automatic variables (defined using DVAR HPcode-Plus SYM instructions) to specific locations on the 
current activation frame (i.e., stack-pointer relative offsets). Likewise, private global and static locaf variables 
are bound to specific locations in the global data area. 

An implicit prerequisite to memory allocation is the mapping of the predefined HPcode-Plus data types 
10 to the target computer platform's data types. When laying out variables in memory, the Low-Level Code 
Generator 1322 must consider the target computer platform's alignment restrictions for the native data 
types. 

For instance, on some computer platforms the Low-Level Code Generator 1322 might be required to 

align a TYPE LONGREAL variable (represented as a double word floating-point object) on a dotfbte-word 

75 boundary. 

Additionally, the Low-Level Code Generator 1322 must consider the packing attributes specified with 

KIND STRUCT variables, as this could dictate the manner in which the structure and fields are laid out in 

memory. 

The Low-Level Code Generator 1322 must also assign character values to character constants in the 
20 HPcode-Plus Object file 1 150, 11 BO. The character values are from an execution character set of the Install 
Sfte 216, 226. For example, suppose the Low-Levei Code Generator 1322 locates the character constant 
Z'101 in the HPcode-Plus Object file 189,585 1150, 1160. Z indicates the execution character set, and 101 
identifies a character within the Z execution character set. The Low-Level Code Generator 1322 then 
exchanges the value for character 101 in the Z character set for occurrences of Z*101 in the HPcode-Plus 
25 Object fief 1150, 1160. 

4.2.3. Symbolic Debug Support 

If the symbolic debug option is specified (via the OPTN HPcode-Plus instruction), then the Low-Level 
30 Code Generator 1322 writes additional information to the Low-Level OR 1338. This information is 
subsequently written to an Object File 1362 by the Object File Generator 1358. The information is then used 
by the native computer platform's symbolic debugger. 

The exact nature and format of this information is dependent on the requirements of the native symbolic 
debugger. In general, the information would include the information contained in the Symbol table 1312 and 
35 Type table 1306. 

4.2.4. Optimization Support 

The Low-Level Code Generator 1322 may provide support for subsequent optimization and register 
40 allocation phases. For example, the Low-Level Code Generator 1322 may perform either limited inter* 
procedural dataflow analysis or procedure in lining. 

4.2.5. Object File Management 

45 The Low-Level Code Generator 1322 also performs object file management tasks. These tasks may be 

shared with the Object File Generator 1358. 

Specifically, the Low-Level Code Generator 1322 arranges for the import and export of global variables 

and functions. The Low-Level Code Generator 1322 produces relocation requests to identify symbolic 

references to imported global variables and functions to the native linker. Also, the Low-Level Code 
so Generator 1322 identifies exported global variables and functions to the native linker so that references in 

other compilation units can be resolved. 

The Low-Level Code Generator 1322 organizes and identifies data areas that correspond to uninitialized 

global memory (BSS), initialized global memory, and literal memory. To do this, the Low-Level Code 

Generator 1322 processes HPcode-Plus INIT instructions, as well as SVAR Symbol Table entries. 
55 The Low-Level Code Generator 1322 processes all other miscellaneous HPcode-Plus options that are 

specified. Examples of options specified using the OPTN HPcode-Plus instruction include: 

ASSEMBLER FILE 

COMPILATION 
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COPYRIGHT 
USER VERSION 
INIT 

s 4.3. Low-Level Optimizer 



The Low-Level Optimizer 1334 performs low-level optimizations on the low-level compiler intermediate 
representation 1338 produced by the Low-Level Code Generator 1322. Ideally, the optimizations performed 
by the Low-Level Optimizer 1334 do not include those machine independent optimizations that could have 
10 been performed by the High-Level Optimizer 1144 of the ANDF Producer 208. Instead, the Low-Level 
Optimizer 1334 performs appropriate pre-register allocation (possibly architecture-specific) optimizations. 

4.4. Register Allocator 

is The Register Allocator 1344 receives the optimized Low-Level CIR 1338 as input and produces Machine 
Instructions 1348. 

The Register Allocator 1344 maps the register requirements expressed in the low-level compiler 
intermediate representation 1338 into the register set of the target computer platform 216, 226. For most 
computer architectures, efficient register allocation dramatically influences run-time performance of the 
20 generated code. The Register Allocator 1344 can be implemented using priority-based graph coloring 
techniques. 

4-5. Machine Specific Optimizer 

25 The Machine Specific Optimizer 1352 performs all post-register allocation optimizations, such as 
peephole optimizations (which exploit the special features of computer platforms) and instruction schedul- 
ing. 

4.6. Object File Generator 

30 

The Object File Generator 1358 receives the Machine instructions 1348 as input. The Object File 
Generator 1358 generates and stores object code In an Object file 1362„ The object code is packed into the 
precise bit patterns expected by the underlying hardware. 

The Object File Generator 1358 writes other required information to the Object file 1362 according to 

35 the format expected by the native linker and loader. This might include Symbol Table 1312 and Type Table 
1306 information, relocation information, and object file management information. 

The Object File 1362 produced by the Object File Generator 1358 is then linked (using the target 
computer platform's native Imker, not shown in Figure 13) with other object files and system libraries to 
produce an executable program (not shown in Figure 13). 

40 It should be noted that the preferred embodiment of the ANDF Installer 218, 228 described above is 

directed to register-based heterogeneous computer platforms. As will be obvious to one with ordinary skill in 
the art the improvements of the present invention as described above can also be applied to stack-based 
heterogeneous computer platforms. For example, an ANDF installer 218, 228 for stack-based heteroge- 
neous computer platforms may contain only the code generator 1322 and the object file generator 1358. 

45 The code generator 1322 would directly receive the HPcode-Plus object file to produce machine instruc- 
tions. The object file generator 1358 would receive the machine instructions to produce object code. 

Claims 

so 1. A computer software compiler system (234), adapted for use with a machine independent computer 
program (202) that may use machine dependent standard header files, and with one or more 
heterogeneous computer platforms (206, 216, 226), said computer software compiler system (234) 
comprising: 

(1) a producer (208), existing on one of the one or more heterogeneous computer platforms (206), 
55 which receives the machine independent computer program (202) as input and which generates a 

compiler intermediate representation (212) of the machine independent computer program (202), 
said compiler intermediate representation (212) comprising compiler intermediate instructions from a 
compiler intermediate language, wherein said producer (208) generates said compiler intermediate 
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representation (212) in a machine independent manner, such that machine dependent decisions are 
deferred, and such that said compiler intermediate representation (212) is architecture neutral and 
represents an architecture neutral distribution format; and 

(2) one or more installers (218, 228), each of said one or more installers residing on the one or more 
5 heterogeneous computer platforms (216, 226), said one or more installers {218, 228) receiving said 

compiler intermediate representation (212) as input and generating object code representations (222, 
232) of the machine independent computer program (202) 3 said object code representations (222, 
232) being machine dependent on the one or more heterogeneous computer platforms (216, 226) 
upon which said one or more installers (218, 228) reside. 

70 

2. The computer software compiler system (234) of claim 1, wherein said producer (208) comprises: 

(1) means (208) for assigning unique key words to standard type identifiers, object-like macro 
identifiers, and/or function-like macro identifiers which are defined in the machine dependent 
standard header files and referenced by the machine independent computer program (202); 

75 (2) means (208) for translating instructions having said standard type identifiers, object-like macro 

identifiers, and/or function-like macro identifiers in the machine independent computer program (202) 
to said compiler intermediate instructions by using said unique key words to refer to said standard 
type identifiers, objecMike macro identifiers, and/or function-like macro identifiers, such that machine 
dependent decisions concerning said standard type identifiers, objecMike macro identifiers, and/or 

20 function-like macro identifiers are deferred to said one or more installers (218, 228), said compiler 

intermediate instructions forming part of said compiler intermediate representation (212). 

3. The computer software compiler system (234) of claim 1, wherein said producer (208) further 
comprises: 

25 (1) means (208) for defining and declaring data types, functions, and/or variables contained in the 

machine independent computer program (202) by using said compiler intermediate instructions for 
creating and assigning unique symbolic identifiers to said data types, said functions, and/or said 
variables, said compiler intermediate instructions forming part of said compiler intermediate repre- 
sentation (212); 

30 (2) means (208) for translating instructions having said data types, said functions, and/or said 

variables in the machine independent computer program (202) to said compiler intermediate 
instructions by using said unique symbolic identifiers to refer to said data types, said functions, 
and/or said variables such that machine dependent decisions concerning said instructions having 
said data types, said functions, and/or said variables are deferred to said one or more installers (218, 

35 228), said compiler intermediate instructions forming part of said compiler intermediate representa- 

tion (212). 

4. The computer software compiler system (234) of any one of the preceding claims, wherein said 
producer (208) further comprises: 

40 (1) means (208) for translating constant expressions, which are not guaranteed to fold without 

overflow, contained in the machine independent computer program (202) to said compiler intermedi- 
ate instructions without evaluating said constant expressions, said compiler intermediate instructions 
forming part of said compiler intermediate representation (212); 

(2) means (208) for assigning unique symbolic identifiers to said constant expressions; and 

45 (3) means (208) for translating instructions having said constant expressions in the machine 

independent computer program (202) to said compiler intermediate instructions by using said unique 
symbolic identifiers to refer to said constant expressions, such that machine dependent decisions 
concerning said constant expressions are deferred to said one or more installers (218, 228), said 
compiler intermediate instructions forming part of said compiler intermediate representation (212). 

50 

5- The computer software compiler system (234) of any one of the preceding claims, wherein said 
producer (208) further comprises a conversion means (208) for conversion of operands in the machine 
independent computer program (202) from a first data type to a second data type by inserting said 
compiler intermediate instructions into said compiler intermediate representation (212), said first data 
55 type and said second data type being from a set of data types, said conversion means (208) operating 
in a machine independent manner such that machine dependent decisions concerning said conversion 
of operands are deferred to said one or more installers (218, 228). 
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The computer software compiler system of any one of the preceding claims, wherein said producer 
(208) further comprises: 

(1) means (208) for assigning two part sequences to character constants in the machine independent 
computer program (202), each of said two part sequences comprising: 

(a) a first part, said first part identifying a first character set; and 

(b) a second part, said second part identifying said character constant within said first character 
set; 

(2) means (208) for translating instructions having said character constants in the machine indepen- 
dent computer program to said compiler intermediate instructions by using said two part sequences 
to refer to said character constants, such that machine dependent decisions concerning said 
character constants are deferred to said one or more installers (218, 228), said compiler intermediate 
instructions forming part of said compiler intermediate representation (212). 

The computer software compiler system (234) of any one of the preceding claims, wherein said 
compiler intermediate representation (212) is distributed to said one or more heterogeneous computer 
platforms (216, 226). 

The computer software compiler system (234) of any one of the preceding claims, wherein each of said 
one or more installers (216, 226) comprise means (216, 226) to make said machine dependent 
decisions that were deferred from said producer (208). 

The computer software compiler system (234) of any one of the preceding claims, wherein said one or 
more installers (218, 228) are replaced by one or more installer interpreters which receive said compiler 
intermediate representation (1160) as input and which execute said HPcode-Plus instructions contained 
therein without converting said compiler intermediate representation (1160) to object code representa- 
tions (222, 232) of the machine independent computer program (202). 
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Instruction 


Dp r nt inn 


Unary Opcode 


CVT 


Convert 




INC 


I ncrement 




NEG 


Negate 




NOT 


Not 




RNO 


Round 




ICVT 


Integral 






Convert 




ACVT 


Arithmetic 






Convert 


Control Opcode 


FJP 


Fal se Junto 




TJP 


True Juhid 




UJP 


Uncondi t i onal 






Jump 




CSJP 


CaSA Jiimn 




CTAB 


Case Table 




CEXP 


Cond i t i nnal 1 v 






Eval hp 






Exoression 




RET 


Return 




ENT 


Procedure 




END 


Entry 




Procedure End 




LAB 


Label 




CSEP 


P nnrl i t i nn ^ 1 






Eval uation 






Separator 




CEND 


Conditional 






Eval uation 






End 


Procedure Call 






Opcode 


CUP 


Call User 






Procedure 




ICUP 


Indirect Call 






User Procedure 




MST 


Mark Stack 




PAR 


Parameter 



Figure 3B 
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Class 


Instruction 


Description 


Stack Manipulation 






Opcode 


DUP 


Dupl i cate 




DEL 


Del ete 




SWP 


Swap 




ROT 


Rotate 


Special Opcode 


MCAL 


Marco Call 




SYM 


Symbol Table 




INIT 


Initial ize 






static data 






area 



Figure 3C 
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Type 


Description 


TYPE SCOMPLEX 
TYPE DCOMPLEX 
TYPEJXOMPIEX 

TYPE PACKED DECIMAL 

TYPE ASCII DECIMAL 

TYPE INT1 

TYPE INT2 

TYPE INT4 

TYPE REAL4 

TYPE REAL8 

TYPE REAL16 

TYPE LOGICAL1 

TYPE LOGICAL2 

TYPE L0GICAL4 


short complex, pair of TYPE REAL 
double complex, pair of TYPE DOUBLE 
long double complex, pair of 
TYPELONGREAL 
packed decimal 
ASCII decimal 

1 byte signed integer 

2 byte signed integer 
4 byte signed integer 
4 byte real 

8 byte real 
16 byte real 

1 byte unsigned integer 

2 byte unsigned integer 
4 byte unsigned integer 



Figure 4A 
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SYM Kind 


Description 


KIND ENTRY 
KIND COMMON 
KIND EQUIV 
KIND COBSTRUCT 
KIND VARIANT 
KIND SET 


Multiple entry point procedure entry 

Common block 

FORTRAN equivalence 

COBOL structure 

Pascal variant record 

Pascal set 



Figure 48 
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Instruction 


Description 


ABS 


computes absolute value. 


A DT 

AB I 


aborts a program* 


CAT 


concatenates two strings. 


LHKd 


checks operand against TRUE or FALSE to 
determine whether to raise an error 
condition* 


CHKL 


checks operand against a limit to determine 
whether to raise an error condition* 


LHKN 


checks operand against the NIL pointer to 
determine whether to raise an error 
condi tion. 


CHKR 


checks operand against a range to determine 
whether to raise an error condition. 


Lor I 


does a circular shift. 


EQUF 


compares two strings for equal relation with 
fill characters. 


EQUT 


compares two strings for equal relation 
using a translation table. 


GEQF 


compares two strings for greater-than-or- 
equal-to relation with fill characters. 


Gel] 1 


compares two strings for greater~than-or~ 
equal to relation using a translation table. 


GET 


gets a piece of dynamic storage. 


roTC 
bK 1 r 


compares two strings for greater-than 
relation with fill characters. 


POTT 


compares two strings for greater- than 
relation with a translation table. 


T c DC 


calls a procedure indirectly with an 
environment descriptor. 


LLA 


loads an address of an constant. 


i ni 
LUL 


loads an address of a label * 




compares two strings for less- than-or~equal - 
to relation with fill characters 


LEQT 


compares two strings for less-than-or-equal - 
to relation using a translation table. 


i rcc 
Lti>r 


compares two strings for less-than relation 
with fill characters. 


LEST 


compares two strings for less-than relation 
using a translation table. 


LSFT 


does a logical shift. 


MAX 


computes the maximum of two operands. 


MIN 


computes the minimum of two operands. 


MOO 


computes a modulo of two operands. 


MOVF 


does a string assignment with fill characters 



Figure 4C1 
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Instruction 


Description 


NEQF 

NEQT 

ODD 
REL 

RIPL 

RIPW 

SCNU 

SCNW 

TRAN 
TYP 


compares two strings for not-equal relation 
with fill characters. 

compares two strings for not-equal relation 

using a translation table. 

checks whether an operand is odd or even. 

release the dynamic storage allocated by a 

previous GET instruction. 

does a string assignment with ripple effect 

when source and taraet overlaD 

does a sgring assignment with ripple effect 

while a specified condition is satisfied. 

scans a string until a pattern is 

encountered and returns the number of bytes 

scanned. 

scans a string while a pattern is 
encountered and returns the number of bytes 
matched. 

performs an in-place translation of a string 
using a translation table, 
does a passive type conversion. 




Figure 4C2 




Figure 4C1 




Figure 4C2 






Figure 4C3 
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Instruction 


Descri ot ion 


CHKV 


checks the operand aoainst a Darticular ' 




value to determine whether to raise an 




error condition* 


DPAR 


prepares an OUT-only parameter before a 




procedure cal 1 * 


DUP2 


duplicates two elements on the too of the 




expression stack. 


DUPR 

W V t IX 


□reoares an IN-onlv oarameter followina a 

fc* I V V> ** * Vr v U If All V* lit V k-/ U| 1 Ut If w w \_ [ f Vr 1 1 W P* III tj, 




nroredurp rail 


ENDM 


ends a module* 


ETRY 


ends a trv recover block. 


EXPP 


exports a procedure. 


EXPV 


exports a variable to another module. 


IMPP 


imports a procedure. 


IMPV 


imports a variable from another module* 


LEC 


loads an escapecode* 


LESC 


performs a local escape. 


MODL 


signals the beginning of a module. 


RNGE 


performs a range checking operation* 


LGET 


get local dynamic storage* 


LREL 


release local dynamic storage. 


NESC 


performs a non-local escape. 


REC 


signals the end of a try block and the start 




of a recover block. 


TRY 


signals the beginning of a try block* 


UPAR 


receives OUT or IN OUT parameter after a 




procedure call . 


UTRY 


reverses the effect of a TRY operation and 




branches to a label * 



Figure 4D 
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Instruction 


Description 


CSGN 


compares signs for equality* 


ENDP 


ends a COBOL paragraph. 


GETS 


gets the sign of an external decimal digit. 


MVRF 


does a string assignment, right justified 




with padding on the left. 


OVPN 


overpunches an external decimal digit. 


PARC 


performs a COBOL paragraph call. 


STRP 


strips the sign of an external decimal 




number. 



Figure 4E 
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Instruction 


Description 


BDP 


deposits a string of bits into an item. 
Used for HIL-STD MVBITS function. 


BRST 


sets a string of bits to zero. Used for 
MIL-STO IBCLR function. 


BSET 


sets a string of bits to 1. Used for 
HIL-STD I BSET function. 


BTST 


tests a bit. Used for MIL-STD BTEST 
function. 


BXT 


extracts a string of bit from an item. Used 
for MIL-STD IBITS function. 


C3JP 


performs a 3 -way jump depending on the 
condition. Used for FORTRAN arithmetic IF 
statement. 


LDL 


loads the address of a label. Used for 
FORTRAN assigned GOTO statement. 


VJP 


does a jump using an address of a label as 
an operand. 



Figure 4F 
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Instruction 



ADJ 

DIF 

GOOB 

INN 

INT 

LDE 

LOPE 

MUS 
SEQU 
SGS 
SHI 

SINC 
SLOW 

SNEQ 
UNI 



Description 



adjusts the size of a set. 
computes difference of two sets, 
go to a label which is not local, 
checks if an element is in a set. 
performs a set intersection, 
loads an environment descriptor for 
lexically scope languages like PASCAL, 
loads an procedure descriptor for lexically 
scope languages like PASCAL, 
constructs a set. 

set equality test, 
a set with a singleton, 
set for elements greater than a 
value. 

set inclusion test, 
set for elements less than a 
value 



performs a 
constructs 
checks the 
high bound 
performs a 
checks the 
lower bound 



performs a set nonequality test 
performs a set union. 



Figure 4G 



8NSDOC1D: <EP__ „ 0463Sa3A2J _> 



65 



BP 0 463 583 A2 



HPcode Plus Data Type 


Description 


TYPE BOOLEAN 
TYPECHAR 

TYPESCHAR 

TYPE SHORT I NT 
TYPE INT 
TYPE LONG I NT 
TYPE UNS SHORT I NT 
TYPE UNS INT 
TYPE UNS LONG I NT 
TYPE REAL 
TYPE DOUBLE 
TYPE LONGREAL 
TYPE ANY PTR 
TYPE VOID 


True/false or LOGICAL 

Character, not sign extended when 

converted to TYPE_INT 

Character, sign extended when 

converted to TYPEINT 

Signed short integer 

Signed integer 

Signed long integer 

Unsigned short integer 

Unsigned integer 

Unsigned long integer 

Float real 

Double real 

Long double real 

Address for unknown type data object 
Void type for function 



Figure 5 
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ANSI-C DATA TYPE 


HPCODE-PLUS DATA TYPE 


Boolean 
Character 
Signed integers 

Unsigned integers 

Floating Point 

Data Pointer or Address 

Enumerated 

Function Pointer 

Array 

Structure 

Union 


TYPE BOOLEAN 
TYPE CHAR, TYPE SCHAR 
TYPE SHORTINT, TYPE INT, 
TYPE LONGINT 

TYPE UNS SHORTINT, TYPE UNS INT, 

TYPE UNS LONGINT 

TYPE REAL, TYPE DOUBLE, 

TYPE LONGREAL 

KIND POINTER SYM type 

KIND ENUM SYM type 

KIND FUNC PTR SYM type 

KIND ARRAY SYM type 

KIND STRUCT SYM type 

KIND UNION SYM type 



Figure 6 
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<sym kind> 


Description 


KIND POINTER 
KIND ENUM 
KIND SUBRANGE 
KING ARRAY 
KIND STRUCT 
KIND UNION 
KIND FIELD 
KIND FUNC PTR 
KIND MODIFIER 


define data pointer type 

define enumeration type 

define subrange type 

define array type 

define structure type 

define union type 

define structure field 

define function pointer type 

define additional attribute such as 

volatile or constant 



Figure 7 
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<COMM & OPTN instructions> 

<LOC instructions> 

<C0MM & OPTN instructions> 

<SYM & INIT instructions for variables/types/constants/ 

functions> 
<SYM or KIND FUNCTION instruction> 
ENT 

<LOC instructions> 
<other instructions> 

<SYM & INIT instructions for variables/ types/constants/ 

functions> 
<other instructions> 

• » m 

END 

<SYM or KIND_END> 

» » • 

<LOC instructions> 

<COMM & OPTN instructions> 

<SYM & INIT instructions for variables/types/constants/ 
functions> 

ENT 

<LOC instructions> 
<other instructions> 

<SYM or INIT instructions for global variables/types/ 

cons t ant s/functions> 
<other instructions> 

END 

<SYM of KIND_END> 

<COMM & OPTN instruct! ons> 



Figure 8 
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Category 



<symid> 



Description 



Void 

Boolean 

Character 



Integral 



Floating 
Any Ptr 



TYPE VOID 
TYPE BOOLEAN 
TYPE CHAR 



TYPE SCHAR 



TYPE_SHORTINT 
TYPE_INT 
TYPEJ.ONGINT 
TYPEUNS_SHORT I NT 
TYPEJJNSJNT 
TYPE_UNS_LONG I NT 
TYPE_REAL 
TYPEJ)OUBLE 
TYPE LONGREAL 
TYPE ANY PTR 



void type for function 
true/false or LOGICAL 
character, not sign 
extended when converted 
to an integer character 
character, sign extended 
when converted to an 
integer 

signed short integer 
signed integer 
signed long integer 
unsigned short integer 
unsigned integer 
unsigned long integer 
short real 
double real 
long real 

pointer to a data object 
of unknown type 



Figure 9 
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Category 


<sym kind> 


Descri ption 


Types 


KIND POINTER 
KIND STRUCT 
KIND UNION 
KIND ARRAY 
KIND ENUM 
KIND FUNC PTR 
KIND_MODIFIER 


define data pointer type 
define structure type 
define union type 
define array type 
define enumerated type 
define function ptr type 
addi ti onal attributes 
for a type 


Field 


KINDFIELD 


define structure field 


Functions 


KIND FUNCTION 
KIND FUNC DCL 
KIND_FPARAM 


function definition 
function declaration 
define formal parameter 


Variables 


KIND SVAR 
KIND DVAR 
KINDMEMBER 

KINDOFFSEOF 

KINO_SI2EOF 


define static variable 
define dynamic variable 
define member of an 
enumerated type 
the offset of a field 
inside a structure 
the size of a type 


Constants 


KIND MAXOF 
KIND MINOF 
KIND_CONST 
KIND_NEW CONST 


max value of an object 
min value of an object 
define constant 
define a new constant 


Mar 1 rn 




ukt i ne a macro 


End 


KIND END 


define end of SYMs 


Symdebug 


KIND_SRCFILE 
KIND_LAB£L 


provide source file info 
for symbolic debug 
provide label info for 
symbol ic debug 




Figure 
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HEADER FILES 

1102 



SYSTEM-SPECIFIC 
HEADER FILES 



1104 



ANDF 
PRODUCER 
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MODIFIED ANDF 
STANDARD HEADER 
FILES 
1106 
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SOURCE FILE 
1118 



FIG. 11 
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SCANNER 
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CODE GENERATOR 
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TYPE 
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OBJECT FILE 
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MACHINE INDEPENDENT 

COMPUTER PROGRAM 
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USER-DEFINED 
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1102 
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HEADER FILES 
1104 
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1 1 06 



1112 



PREPROCESSOR 
1114 



COMPILER 
1 1 22 
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ANDF 
INSTALLER 
218. 228 



HPCODE-PLUS 
OBJECT FILE 
1150.1160 



( ANDF HEADER^ 
FILE 
1 370 




+ 1302 



372 



TUPLE 
GENERATOR 
1304 



+ 1314 



1310 



SYMBOL 
TABLE 
1 31 2 



QUADRUPLES 
1318 



1316 



+ 1 320 



LOW-LEVEL 
CODE GENERATOR 
1322 

+1324 ~ 




LOW-LEVEL 
CIR 
1 338 





LOW-LEVEL 


*13 32 * 


OPTIMIZER 


1334 



MACHINE 

CONFIGURATION 

FILE 
1328 

+ 1330 

MACHINE SPECIFIC 

OPTIMIZER 
1352 



342 



+ 1340 



pi 



REGISTER ALLOCATOR 

1 344 
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1356 
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#include<stdio.h> 
/* 

* sample program 
V 

struct {int i; long j;} x = {1, 10L); 

main() 
{ 

char k; 

char s[65536]; 

register char *p; 

struct {int i; long j;> y; 

int jebl = 0; 

while (gets(S) ! = NULL) { 

for (p - s + strlens(S) - 1; 

p >- s && (*p =="||*p=='\t'); 

p-->; 

k = s[strien(s)-l] ; 

*{++p) - '\0'; 

if ((P!=s) !J !jebl) 

puts(s); 
jebl = (p==s); 

fflush(stdout); 
exit(O); 

} 

Figure 14 
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SYM 256 KIND_POINTER 0 TYPEJ/010 

SYM 257 KIND_PO INTER 0 TYPEIONGINT 

SYM 258 KIND_POINTER 0 TYPE_CHAR 

SYM 259 KIND ARRAY 0 55536 TYPE_CHAR 0 

SYM 260 KIND_POINTER 0 TYPE_CHAR 

SYM 261 KINDPOINTER 0 TYPEJ)OUBLE 

SYM 262 KIND_STRUCT 0 263 0 

SYM 264 KIND_POINTER 0 262 

SYM 265 KINDARRAY 0 60 262 0 

SYM 266 KIND_P01NTER 0 TYPE_CHAR 

SYM 267 KIND_POINTER 0 TYPE_LONGINT 

SYM 268 KIND_POINTER 0 TYPE_VOID 

SYM 269 KIND_STRUCT 0 270 0 

SYM 271 KIND_STRUCT 0 272 0 

SYM 272 KINO_FIELO TYPE_INT 273 i 

SYM 273 KINDFIELD TYPE_LQNGINT 0 J 

SYM 270 KINDFIELD TYPE_INT 274 i 

SYM 274 KINDFIELD TYPE_LONGINT 0 j 

SYM 275 KIND_FIELD 260 276 _ptr 

SYM 276 KIND_FIELD 260 277 _base 

SYM 277 KIND FIELD TYPE SHORTINT 278 flag 

SYM 278 KIND_FIELD TYPE_CHAR 0 „file 

SYM 279 KIND_SVAR 0 265 1 _iob 

SYM 280 KIND_FUNC_DCL 0 TYPE INT remove 

SYM 281 KIND_FUNCT_DCL 0 TYPE_INT rename 

SYM 282 KIND_FUNC_DCL 0 264 tmpfile 

SYM 283 KIND_FUNC_DCL 0 258 tmpnam 

SYM 284 KIND_FUNC_DCL 0 TYPE_INT fclose 

SYM 285 KIND_FUNC_DCL 0 TYPE_INT f flush 

SYM 286 KIND_FUNC DCL 0 264 fopen 

SYM 287 KIND_FUNCJDCL 0 264 freopen 

SYM 288 KIND_FUNC_DCL 0 TYPE_VOID setbuf 

SYM 289 KIND_FUNC_DCL 0 TYPE_INT setvbuf 

SYM 290 KIND_FUNC DCL 0 TYPE INT fprintf 

SYM 291 KIND_FUNC_DCL 0 TYPE_INT fscanf 

SYM 292 KIND_FUNC_DCL 0 TYPEINT printf 

SYM 293 KIND FUNC DCL - TYPE_INT scanf 

SYN 294 KIND_FUNCDCL 0 TYPE INT sprintf 

SYM 295 KIND_FUNC_DCL 0 TYPE_INT sscanf 

SYM 296 KIND_FUNC_DCL 0 TYPE_INT vprintf 

SYM 297 KIND_FUNC_DCL 0 TYPE_INT vsprintf 

SYM 299 KIND_FUNC_DCL 0 TYPE_INT fgetc 

SYM 300 KIND_FUNC_DCL 0 258 fgets 

SYM 301 KIND_FUNC_DCL 0 TYPE_INT fputc 

SYM 302 KIND_FUNC_DCL 0 TYPE_INT fputs 

SYM 303 KIND_FUNC_DCL 0 TYPEJNT getc 

SYM 304 KIND_FUNC_DCL - TYPE_INT getchar 

SYM 305 KINDFUNCDCL 0 258 gets 

SYM 306 KIND_FUNC_DCL 0 TYPE_INT putc 

SYM 307 KIND_FUNC_DCL 0 TYPEJNT putchar 



Figure 15A 
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SYM 308 KIND_FUNC_DCL 0 TYPE INT puts 
SYH 309 KIND_FUNC_DCL 0 TYPE~INT ungetc 
SYM 310 KIND_FUNC DCL 0 TYPEINT fgetpos 
SYH 311 KIND_FUNCJ)CL 0 TYPE~INT fseek 
SYM 312 KIND_FUNC__DCL 0 TYPE~INT fsetpos 
SYM 313 KIND_FUNC DCL 0 TYPE~L0NGINT ftell 
SYM 314 KIND_FUNC_DCL 0 TYPE"VOID rewind 
SYM 315 KIND_FUNC__DCL 0 TYPE~VOID clearerr 
SYM 316 KIND_FUNC_DCL 0 TYPE"" I NT feof 
SYM 317 KIND_FUNC_0CL - TYPE~INT ferror 
SYM 318 KINDJUNC DCL 0 TYPE~V0ID perror 
SYM 319 KIND_FUNC_DCL 0 TYPE~UNS INT fread 
SYM 320 KIND FUNC DCL 0 TYPE~UNS"INT fwrite 
SYM 321 KINDSVAR- 269 0 x " ~ 
SYM 322 KIND CONST 1 269 [ 1 10 1 
INIT 321 322" 

SYM 323 KIND FUNCTION TYPE INT 0 main 

ENT 323 " ~ 

SYM 324 KIND DVAR TYPE CHAR 0 k 

SYM 325 KIND_DVAR 259 0 s 

SYM 326 KIND DVAR 258 1 p 

SYM 327 KINDJ3VAR 271 0 y 

SYM 328 KIND DVAR TYPE INT 0 jebl 

ISTR 

LDC TYPE_INT 0 
LDA 328 
LAB 0 0 
MST 

LDA 325 
CVT 258 
PAR 

CUP 305 

LDC TYP£_ANY_PTR 0 

NEQ FJP 1 

LDA 325 

CVT 258 

PAR 

CUP 329 

IXE TYPE_CAR 

LDC TYPE INT 1 

NEC 

IXE TYPECHAR 

LDA 326 

SWP 

ISTR 

LAB 4 0 

LOD 326 

LDA 325 

CVT 258 

GEQ 

FJP 3 



Figure 15B 
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LOD 326 
ROD 

CVT TYPEJNT 

LDC TYPEINT " " 

EQU 

TJP 5 

LOD 326 

I LOD 

CVT TYPEJNT 

LDC TYPEINT " 

EQU 

FJP 3 

LAB 5 0 

LAB 2 0 

LDA 326 

DUP 

ILOD 

DUP 

IMC -1 

ROT 

SWP 

ISTR 

DEL 

UJP 4 

LAB 3 0 

LDA 325 

MST 

LDA 325 
CVT 258 
PAR 

CUP 329 

LDC TYPE_JNT 1 

SUB 

IXE TYPE_CHAR 

ILOD 

LDA 324 

SWP 

ISTR 

LDC TYPE CHAR 0 

LDA 326 

DUP 

ILOD 

INC 1 

INST 

SWP 

ISTR 

LOD 326 

LDA 325 

CVT 258 

NEQ 

TJP 7 

LDC TYPE INT 0 
LOD 328 

Figure 15C 
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NEQ 
TJP 6 
LAB 7 0 
MST 

LDA 325 
CVT 266 
PAR 

CUP 308 
DEL 

LAB 6 0 
LOD 326 
LDA 325 
CVT 28 
EQU 

CVT TYPE INT 

LDA 328 " 

SWP 

ISTR 

UOP 0 

LAB 1 0 

MST 

LDA 279 

LDC TYPE INT 1 
1XE 262 " 
PAR 

CUP 285 
DEL 

SYM 330 KIND FUNC DCL 0 TYPE INT exit 
MST ~ 
LDC TYPE INT 0 
PAR 

CUP 330 
DEL 

END 323 

SYM 323 KIND_END 

Figure 15D 
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